MCP Compact
MCP Compact aggregates multiple upstream MCP servers into one stdio-only runtime with a single compact surface.
What It Is
MCP Compact runs as one MCP server over stdio and exposes only invoke and read.
Use From An MCP Client
MCP Compact runs as a stdio MCP server. It does not expose HTTP or /mcp.
Configure your MCP client to launch it like this:
{
"mcpServers": {
"mcp_compact": {
"command": "uv",
"args": ["run", "mcp-compact", "config.example.json"]
}
}
}If you want to start it manually, run:
uv run mcp-compact config.example.jsonUpstream Config
config.example.json is the config file consumed by mcp-compact itself:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}All upstreams must use stdio.
Test
uv run ruff check src/mcp_compact tests
uv run mypy src/mcp_compact
uv run pytest tests/ -q
