mcp_server_aggregator

MCP aggregator example

This example shows connecting to multiple MCP servers via the MCPAggregator interface. An MCP aggregator will combine multiple MCP servers into a single interface allowing users to bypass limitations around the number of MCP servers in use.

┌────────────┐      ┌──────────────┐
│ Aggregator │──┬──▶│  Fetch       │
└────────────┘  │   │  MCP Server  │
                │   └──────────────┘
                |   ┌──────────────┐
                └──▶│  Filesystem  │
                    │  MCP Server  │
                    └──────────────┘

1 App set up

First, clone the repo and navigate to the basic‑agent example:

git clone https://github.com/lastmile-ai/mcp-agent.git
cd mcp-agent/examples/basic/mcp_server_aggregator

Install uv (if you don’t have it):

pip install uv

Sync mcp-agent project dependencies:

uv sync

Install requirements specific to this example:

uv pip install -r requirements.txt

2 Set up secrets and environment variables

Copy and configure your env variables:

cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml

Then open mcp_agent.secrets.yaml and add your api key for your preferred LLM.

3 Run locally

Run your MCP Agent app:

uv run main.py

4 [Beta] Deploy to the cloud

a. Log in to MCP Agent Cloud

uv run mcp-agent login

b. Deploy your agent with a single command

uv run mcp-agent deploy mcp-server-aggregator

c. Connect to your deployed agent as an MCP server through any MCP client

Claude Desktop Integration

Configure Claude Desktop to access your agent servers by updating your ~/.claude-desktop/config.json:

"my-agent-server": {
  "command": "/path/to/npx",
  "args": [
    "mcp-remote",
    "https://[your-agent-server-id].deployments.mcp-agent.com/sse",
    "--header",
    "Authorization: Bearer ${BEARER_TOKEN}"
  ],
  "env": {
        "BEARER_TOKEN": "your-mcp-agent-cloud-api-token"
      }
}

MCP Inspector

Use MCP Inspector to explore and test your agent servers:

npx @modelcontextprotocol/inspector 

Make sure to fill out the following settings:

Setting	Value
Transport Type	SSE
SSE	https://[your-agent-server-id].deployments.mcp-agent.com/sse
Header Name	Authorization
Bearer Token	your-mcp-agent-cloud-api-token

Tip

In the Configuration, change the request timeout to a longer time period. Since your agents are making LLM calls, it is expected that it should take longer than simple API calls.