Ibmcloud MCP Server

🚀 ibmcloud-mcp-server

An MCP server that wraps the IBM Cloud CLI, offering over 80 tools for authentication, resource management, Cloud Foundry, Kubernetes, Container Registry, IAM, catalog, and billing operations.

🚀 Quick Start

The ibmcloud-mcp-server wraps the IBM Cloud CLI and provides more than 80 tools for various operations.

✨ Features

• Rich Toolset: Offers over 80 tools covering authentication, resource management, Cloud Foundry, Kubernetes, Container Registry, IAM, catalog, and billing operations.
• MCP Compatibility: Compatible with the Model Context Protocol (MCP).

📦 Installation

Prerequisites

Install the IBM Cloud CLI:

curl -fsSL https://clis.cloud.ibm.com/install/osx | sh

Install the Server

npm install
npm run build

💻 Usage Examples

Configuration

{
  "mcpServers": {
    "ibmcloud": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/ibmcloud-mcp/dist/index.js"]
    }
  }
}

📚 Documentation

Tools (80+)

Authentication (8 tools)

Resource Management (14 tools)

ibmcloud_resource_groups, ibmcloud_resource_group_create, ibmcloud_resource_service_instances, ibmcloud_resource_service_instance, ibmcloud_resource_service_instance_create, ibmcloud_resource_service_instance_delete, ibmcloud_resource_service_instance_update, ibmcloud_resource_service_keys, ibmcloud_resource_service_key, ibmcloud_resource_service_key_create, ibmcloud_resource_service_key_delete, ibmcloud_resource_search, ibmcloud_resource_tags, ibmcloud_resource_tag_attach

Cloud Foundry (20 tools)

ibmcloud_cf_orgs, ibmcloud_cf_spaces, ibmcloud_cf_apps, ibmcloud_cf_app, ibmcloud_cf_push, ibmcloud_cf_start, ibmcloud_cf_stop, ibmcloud_cf_restart, ibmcloud_cf_delete, ibmcloud_cf_logs, ibmcloud_cf_env, ibmcloud_cf_set_env, ibmcloud_cf_scale, ibmcloud_cf_routes, ibmcloud_cf_services, ibmcloud_cf_marketplace, ibmcloud_cf_create_service, ibmcloud_cf_bind_service, ibmcloud_cf_unbind_service

Kubernetes (15 tools)

ibmcloud_ks_clusters, ibmcloud_ks_cluster, ibmcloud_ks_cluster_config, ibmcloud_ks_cluster_create, ibmcloud_ks_cluster_delete, ibmcloud_ks_workers, ibmcloud_ks_worker_pools, ibmcloud_ks_worker_pool_create, ibmcloud_ks_worker_pool_resize, ibmcloud_ks_zones, ibmcloud_ks_versions, ibmcloud_ks_flavors

Container Registry (5 tools)

ibmcloud_cr_namespaces, ibmcloud_cr_namespace_add, ibmcloud_cr_images, ibmcloud_cr_image_rm, ibmcloud_cr_quota

IAM (18 tools)

ibmcloud_iam_users, ibmcloud_iam_user_invite, ibmcloud_iam_api_keys, ibmcloud_iam_api_key_create, ibmcloud_iam_api_key_delete, ibmcloud_iam_service_ids, ibmcloud_iam_service_id, ibmcloud_iam_service_id_create, ibmcloud_iam_service_id_delete, ibmcloud_iam_service_api_keys, ibmcloud_iam_service_api_key_create, ibmcloud_iam_access_groups, ibmcloud_iam_access_group, ibmcloud_iam_access_group_create, ibmcloud_iam_access_group_users, ibmcloud_iam_access_group_user_add, ibmcloud_iam_access_group_policies, ibmcloud_iam_access_group_policy_create, ibmcloud_iam_roles

Catalog and Billing (7 tools)

ibmcloud_catalog_search, ibmcloud_catalog_service, ibmcloud_catalog_service_plans, ibmcloud_billing_account_usage, ibmcloud_billing_resource_group_usage, ibmcloud_billing_resource_instances_usage, ibmcloud_billing_org_usage

Plugins (4 tools)

ibmcloud_plugin_list, ibmcloud_plugin_repo_plugins, ibmcloud_plugin_install, ibmcloud_version

🔧 Technical Details

Architecture

The server wraps the ibmcloud CLI binary, parsing JSON output from each command into structured MCP tool responses. Authentication state is managed by the CLI itself.

Project Structure

src/index.ts    # MCP server with 80+ tool definitions
src/cli.ts      # IBM Cloud CLI execution wrapper
tsconfig.json   # TypeScript configuration
dist/           # Compiled output

📄 License

MIT