Content
# MetaMCP (Unified middleware MCP to manage all your MCPs)
[](https://discord.gg/mNsyat7mFX)
https://metamcp.com (Cloud version online now and available for free)
MetaMCP is "the One" middleware MCP to manage all your MCPs. It uses a GUI fullstack app (this repo) and a local MCP proxy to achieve this. (see our latest npm repo [mcp-server-metamcp](https://github.com/metatool-ai/mcp-server-metamcp))
A few feature highlights:
- GUI app to manage multiple MCP server integrations all together.
- Support ANY MCP clients (e.g., Claude Desktop, Cursor, etc.) because MetaMCP is a MCP server.
- Support prompts, resources, tools under MCP.
- Support multi-workspace: e.g., activate a workspace of DB1 or switch to DB2 in another workspace, preventing polluting context of DB1 to your MCP Client.
- Tool level toggle on/off
The app is also self hostable, free and open source. There is also a cloud version. You can try how this app works using cloud version but I actually encourage you to self host if you are familiar with docker: it will provide unlimited access with lower latency, full private operations on your end.
Check out demo videos at https://metamcp.com/. Here is an overview screenshot.
## Verified Platform
- [x] Windows (after MCP official typescript SDK 1.8.0, which we updated accordingly, it works) https://github.com/metatool-ai/metatool-app/issues/15
- [x] Mac
- [x] Linux
## Installation
To get instantly started with cloud version visit https://metamcp.com/.
To get started with this self hostable version of MetaMCP App, the eastiest way is to clone the repository and use Docker Compose to run it.
```bash
git clone https://github.com/metatool-ai/metatool-app.git
cd metatool-app
cp example.env .env
docker compose up --build -d
```
Then open http://localhost:12005 in your browser to open MetaMCP App.
It is recommended to have npx (node.js based mcp) and uvx (python based mcp) installed globally.
To install uv check: https://docs.astral.sh/uv/getting-started/installation/
You also need a MCP Client to connect to `@metamcp/mcp-server-metamcp`. For example if you are using [Claude Desktop](https://modelcontextprotocol.io/quickstart/user), the config json may look like this:
```json
{
"mcpServers": {
"MetaMCP": {
"command": "npx",
"args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
"env": {
"METAMCP_API_KEY": "<your api key>",
"METAMCP_API_BASE_URL": "http://localhost:12005"
}
}
}
}
```
For Cursor, env vars aren't easy to get typed in so you may use args instead
```bash
npx -y @metamcp/mcp-server-metamcp@latest --metamcp-api-key <your-api-key> --metamcp-api-base-url <base-url>
```
You can get the API key from the MetaMCP App's API Keys page (self hosted available).
## Architecture Overview
Note that prompts and resources are also covered similar to tools.
```mermaid
sequenceDiagram
participant MCPClient as MCP Client (e.g., Claude Desktop)
participant MetaMCPMCP as MetaMCP MCP Server
participant MetaMCPApp as MetaMCP App
participant MCPServers as Installed MCP Servers in MetaMCP App
MCPClient ->> MetaMCPMCP: Request list tools
MetaMCPMCP ->> MetaMCPApp: Get tools configuration & status
MetaMCPApp ->> MetaMCPMCP: Return tools configuration & status
loop For each listed MCP Server
MetaMCPMCP ->> MCPServers: Request list_tools
MCPServers ->> MetaMCPMCP: Return list of tools
end
MetaMCPMCP ->> MetaMCPMCP: Aggregate tool lists
MetaMCPMCP ->> MCPClient: Return aggregated list of tools
MCPClient ->> MetaMCPMCP: Call tool
MetaMCPMCP ->> MCPServers: call_tool to target MCP Server
MCPServers ->> MetaMCPMCP: Return tool response
MetaMCPMCP ->> MCPClient: Return tool response
```
## License
GNU AGPL v3
## Credits
- (Deprecated) Demo video uses MCP Client [5ire](https://5ire.app/)
