mcp-blender

Easily manage, compose, and route MCP (Model Context Protocol) servers in Python projects.

Installation

pip install mcp-blender

Usage

Registry — manage servers

from mcp_blender import MCPServer, ServerTransport, Registry

reg = Registry()

reg.add(MCPServer(
    name="filesystem",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
    tools=["read_file", "write_file", "list_directory"],
    tags=["io"],
))

reg.add(MCPServer(
    name="github",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-github"],
    env={"GITHUB_TOKEN": "ghp_xxx"},
    tools=["search_repositories", "create_issue"],
    tags=["code"],
))

# Load from claude_desktop_config.json
reg.load_claude_config("~/.claude/claude_desktop_config.json")

# Or from YAML
reg.load_yaml("mcp-servers.yaml")

Blender — profiles for different contexts

from mcp_blender import Blender

blend = Blender()
blend.register(filesystem_server)
blend.register(github_server)
blend.register(slack_server)

blend.create_profile("coding", ["filesystem", "github"])
blend.create_profile("comms", ["slack"])

blend.activate("coding")   # starts filesystem + github
blend.activate("comms")    # stops coding servers, starts slack

Router — route tool calls

from mcp_blender import Router

router = Router(reg)
server = router.resolve("read_file")  # → filesystem server
print(router.all_tools())

CLI

mcp-blender list servers.yaml
mcp-blender export servers.yaml -o claude_desktop_config.json
mcp-blender import claude_desktop_config.json -o servers.yaml

License

MIT