cloud-foundry-mcp

cpage-pivotal/cloud-foundry-mcp

3.4

If you are the rightful owner of cloud-foundry-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Cloud Foundry MCP Server provides an LLM interface for interacting with your Cloud Foundry foundation, utilizing the Spring AI MCP project.

Cloud Foundry MCP Server

This MCP Server provides an LLM interface for interacting with your Cloud Foundry foundation. It was built with the Spring AI MCP Server Boot Starter.

Sample

IMPORTANT

This MCP Server now uses the Streamable HTTP Transport, instead of SSE. If you are connecting to this server with Tanzu Platform Chat, be sure to consult the README for instructions on configuring the service binding for Streamable transport.

Building the Server

./mvnw clean package

Deploying to Cloud Foundry with User-Provided Service

When deploying the MCP server to Cloud Foundry, you can use a user-provided service to inject credentials instead of using environment variables. This approach keeps sensitive credentials out of your manifest files.

Create the User-Provided Service

Create a user-provided service named cf-client with the required Cloud Foundry credentials:

cf create-user-provided-service cf-client -p '{
  "apihost": "api.sys.mycf.com",
  "username": "your-cf-username",
  "password": "your-cf-password",
  "org": "your-org",
  "space": "your-space"
}'

Or create it interactively by providing credentials one at a time:

cf create-user-provided-service cf-client -p "apihost, username, password, org, space"
Bind the Service to Your Application

After deploying the application, bind the service:

cf bind-service cloud-foundry-mcp cf-client
cf restart cloud-foundry-mcp

Or include the service binding in your manifest.yml:

applications:
- name: cloud-foundry-mcp
  memory: 1G
  instances: 1
  path: target/cloud-foundry-mcp-0.0.1-SNAPSHOT.jar
  services:
  - cf-client

The application will automatically read credentials from the cf-client service binding via the VCAP_SERVICES environment variable, as configured in src/main/resources/application.yaml.

Update the Service Credentials

If you need to update the credentials:

cf update-user-provided-service cf-client -p '{
  "apihost": "api.sys.mycf.com",
  "username": "new-username",
  "password": "new-password",
  "org": "new-org",
  "space": "new-space"
}'
cf restart cloud-foundry-mcp

Capabilities

This MCP server exposes the following Cloud Foundry operations as tools:

Application Management (8 tools)

  • applicationsList - List all applications in a space
  • applicationDetails - Get detailed information about a specific application
  • cloneApplication - Clone an existing application
  • scaleApplication - Scale application instances, memory, or disk quota
  • startApplication - Start a stopped application
  • stopApplication - Stop a running application
  • restartApplication - Restart an application
  • deleteApplication - Delete an application

Organization & Space Management (7 tools)

  • organizationsList - List all organizations
  • organizationDetails - Get details about a specific organization
  • spacesList - List all spaces in an organization
  • getSpaceQuota - Get quota information for a space
  • createSpace - Create a new space
  • deleteSpace - Delete a space
  • renameSpace - Rename an existing space

Service Management (6 tools)

  • serviceInstancesList - List all service instances in a space
  • serviceInstanceDetails - Get details about a specific service instance
  • serviceOfferingsList - List available service offerings
  • bindServiceInstance - Bind a service instance to an application
  • unbindServiceInstance - Unbind a service instance from an application
  • deleteServiceInstance - Delete a service instance

Route Management (6 tools)

  • routesList - List all routes in a space
  • createRoute - Create a new route
  • deleteRoute - Delete a specific route
  • deleteOrphanedRoutes - Delete all unmapped routes
  • mapRoute - Map a route to an application
  • unmapRoute - Unmap a route from an application

Network Policy Management (3 tools)

  • addNetworkPolicy - Create network policy between applications
  • listNetworkPolicies - List all network policies
  • removeNetworkPolicy - Remove network policy between applications

Application Cloning (1 tool)

All tools support multi-context operations with optional organization and space parameters to target different environments.