MCP Compose
MCP Compose is a unified control plane for multiple Model Context Protocol (MCP) servers. It exposes a single MCP endpoint, a REST API, and a modern Web UI for orchestration, monitoring, and tool invocation.
What you can do with MCP Compose
- Compose multiple MCP servers into one unified interface
- Discover and invoke tools across servers with conflict resolution
- Manage server lifecycles (start/stop/restart) from UI, CLI, or API
- Translate protocols between STDIO and Streamable HTTP (SSE deprecated)
- Observe in real time with metrics, logs, and health checks
Get Started
Ready to try MCP Compose? Head to the Getting Started guide to install and run your first composed MCP server in minutes.
Looking for practical configurations? Check out the Examples page for runnable examples covering transports, authentication, and production setups.
Documentation
📄️ MCP Compose
MCP Compose is a unified control plane for multiple Model Context Protocol (MCP) servers. It exposes a single MCP endpoint, a REST API, and a modern Web UI for orchestration, monitoring, and tool invocation.
📄️ Getting Started
This guide walks through installing MCP Compose, creating a configuration, and launching the server with Web UI and REST API.
📄️ Architecture
MCP Compose acts as a facade for multiple managed MCP servers. It aggregates tools, prompts, and resources into a single unified server and exposes that aggregation through MCP transports, a REST API, and a Web UI.
📄️ Configuration
MCP Compose is configured using a TOML file, typically named mcp_compose.toml. This page provides a comprehensive reference for all configuration options.
📄️ Examples
Below are practical examples for composing and proxying MCP servers. Use them as templates for your own configurations.
📄️ Clients
MCP Compose can be used with any MCP-compatible client. This guide covers configuration for the two most popular clients: Claude Desktop and VS Code.
📄️ Tool Discovery
MCP Compose aggregates tools across all managed MCP servers and exposes them through CLI, REST API, and the Web UI.
📄️ Operations
This section covers runtime operations: starting/stopping servers, invoking tools, and monitoring the system.
📄️ Integrations
MCP Compose integrates with applications and agent frameworks via three main interfaces:
📄️ Deployments
This guide covers Docker, docker-compose, and Kubernetes deployment patterns for MCP Compose.
📄️ API Reference
This page summarizes the MCP Compose REST and WebSocket APIs. All endpoints are prefixed by /api/v1 unless configured otherwise.
📄️ Contributing
Thank you for contributing to MCP Compose. This page summarizes the workflow and standards for changes.