Docker MCP Orchestrator

Docker MCP编排器

🎯 描述

Docker MCP Orchestrator是一个智能MCP服务器管理系统，在AI客户端（Cursor）和许多MCP服务器之间充当代理/网关。Orchestrator提供管理服务器的工具，并代理与正在运行的服务器的所有通信。

关键能力

• ✅ 管理MCP服务器：启动、停止、检索服务器信息
• ✅ 代理功能：与运行的服务器的所有通信都通过Orchestrator进行
• ✅ 配置管理：服务器配置，秘密管理
• ✅ 工业控制：自动提取和提供服务器插件
• ✅ 缓存：高效的元数据缓存以提高性能
• ✅ 14工具：管理MCP服务器的全套工具

______________________________________________________________________

📋 要求

• DockerиDocker作曲
• 安装了MCP工具包的Docker Desktop
• 添加到Docker MCP目录的MCP服务器

______________________________________________________________________

🚀 安装和启动

项目启动 通过Docker容器依赖关系是通过Poetry管理的。

1.构建Docker映像

docker build -t docker-mcp-orchestrator .

2.启动集装箱

docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/config:/app/config:ro \
  docker-mcp-orchestrator

使用Docker Compose：

docker-compose up -d

3.将图像发布到Docker Registry

图片来源：Docker Hub： semenovsd/docker-mcp-orchestrator

可用标签：

• semenovsd/docker-mcp-orchestrator:latest -最新版本
• semenovsd/docker-mcp-orchestrator:0.1.0 版本0.1.0

使用已发布的图像：

# Скачать и запустить образ из Docker Hub
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/config:/app/config:ro \
  semenovsd/docker-mcp-orchestrator:latest

要发布新版本：

# Сборка образа
docker build -t docker-mcp-orchestrator:latest .

# Тегирование для публикации
docker tag docker-mcp-orchestrator:latest semenovsd/docker-mcp-orchestrator:latest
docker tag docker-mcp-orchestrator:latest semenovsd/docker-mcp-orchestrator:0.1.0

# Публикация в Docker Hub
docker push semenovsd/docker-mcp-orchestrator:latest
docker push semenovsd/docker-mcp-orchestrator:0.1.0

4.添加到Cursor

将Orchestrator添加到Cursor MCP服务器配置中（.cursor/mcp.json):

{
  "mcpServers": {
    "docker-mcp-orchestrator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v", "/var/run/docker.sock:/var/run/docker.sock",
        "-v", "/path/to/docker-mcp-orchestrator/config:/app/config:ro",
        "docker-mcp-orchestrator"
      ]
    }
  }
}

或者使用Docker Hub中发布的图像：

{
  "mcpServers": {
    "docker-mcp-orchestrator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v", "/var/run/docker.sock:/var/run/docker.sock",
        "-v", "/path/to/docker-mcp-orchestrator/config:/app/config:ro",
        "semenovsd/docker-mcp-orchestrator:latest"
      ]
    }
  }
}

使用Docker Compose：

{
  "mcpServers": {
    "docker-mcp-orchestrator": {
      "command": "docker-compose",
      "args": [
        "-f", "/path/to/docker-mcp-orchestrator/docker-compose.yml",
        "exec",
        "-T",
        "orchestrator",
        "python",
        "-m",
        "orchestrator"
      ]
    }
  }
}

______________________________________________________________________

📚 使用

Workflow与Orchestrator合作

1. 获取已安装服务器的列表:

   list_installed_servers()

1. 探索服务器的功能:

   get_server_tools(server="github-mcp")
   get_server_info(server="github-mcp")

1. 配置 （如有必要）：

   secret_set(key="GITHUB_TOKEN", value="your-token")
   config_set(server="postgres-mcp", config={"DATABASE_URL": "postgres://..."})

1. 运行所需的服务器:

   start_servers(servers=["github-mcp", "postgres-mcp"])

启动后，您将收到：

- 列出可用的工具 - 要添加到上下文中的插件（如果有）

1. 通过代理使用工具:

   call_tool(tool_name="github_create_repo", arguments={"name": "my-repo"})

1. 完成后停止服务器:

   stop_servers(servers=["github-mcp", "postgres-mcp"])

可用的工具

服务器管理（5 tools）

• list_installed_servers -已安装服务器列表
• list_catalog_servers -目录中的服务器列表
• start_servers -启动服务器
• stop_servers -停止服务器
• get_active_servers -活动服务器列表

服务器信息（2 tools）

• get_server_tools -服务器工具元数据
• get_server_info -服务器详细信息

配置管理（5 tools）

• config_set -配置设置
• config_get -获取配置
• secret_set -设置秘密
• secret_list 秘密清单
• secret_remove -去除秘密

代理（2个工具）

• call_tool -通过代理调用工具
• list_active_tools -活动工具列表

______________________________________________________________________

🤖 AI提示规则

文件 .cursorrules 已创建 用一个简短的启动（1个句子）来节省代币。

内容：

Все вызовы tools от запущенных MCP серверов идут ТОЛЬКО через call_tool(tool_name, arguments). 
Начинай с list_installed_servers(), настраивай конфигурацию перед запуском через start_servers(), 
и обязательно добавляй промпты в контекст при запуске серверов.

重新启动cursor 为了执行规则。

完整文档: prompts/ai_rules.md （仅供参考，不会自动下载）

______________________________________________________________________

🏗️ 建筑

组件

1. 编排器MCP服务器 -带有14个工具的主服务器
2. Docker MCP客户端 与Docker MCP Toolkit集成
3. 连接池 管理与MCP服务器的连接
4. 代理层 -路由请求到服务器
5. 缓存管理器 -缓存元数据
6. 快速经理 -工业品管理

相互作用电路

Cursor → Orchestrator MCP Server (14 tools)
              │
              ├─► Docker MCP Toolkit CLI
              │
              └─► Proxy Layer
                  ├─► Connection Pool
                  │   ├─► github-mcp
                  │   ├─► postgres-mcp
                  │   └─► ...
                  │
                  └─► Tool Router

______________________________________________________________________

📝 配置

配置在 config/config.yaml:

orchestrator:
  cache:
    servers_ttl: 300  # 5 минут
    tools_ttl: 600    # 10 минут
  
  docker_mcp:
    catalog: "docker-mcp"
    command_timeout: 30
    
  proxy:
    connection_pool_size: 10
    connection_timeout: 30
    reconnect_attempts: 3

______________________________________________________________________

🔧 开发

项目结构

docker-mcp-orchestrator/
├── src/
│   └── orchestrator/
│       ├── __init__.py
│       ├── __main__.py            # Точка входа
│       ├── server.py              # Основной MCP сервер
│       ├── docker_client.py       # Docker MCP Toolkit клиент
│       ├── cache.py                # Кэширование
│       ├── connection_pool.py      # Пул соединений
│       ├── proxy.py                # Proxy layer
│       ├── prompt_manager.py       # Управление промптами
│       ├── models.py               # Модели данных
│       ├── exceptions.py           # Исключения
│       ├── utils.py                # Утилиты
│       └── tools/                  # Все tools
├── config/
│   └── config.yaml                 # Конфигурация
├── prompts/
│   └── ai_rules.md                 # AI правила
├── Dockerfile                      # Docker образ
├── docker-compose.yml              # Docker Compose конфигурация
├── .dockerignore                   # Исключения для Docker
├── .gitignore                      # Исключения для Git
├── README.md
└── pyproject.toml                   # Poetry конфигурация

依赖关系管理

项目使用 诗歌 来管理依赖关系。所有依赖关系定义为 pyproject.toml.

更新依赖关系：

# Внутри Docker контейнера
poetry lock
poetry install

图像构建

docker build -t docker-mcp-orchestrator .

______________________________________________________________________

⚠️ 重要评论

连接池

重要：连接到运行的MCP服务器的机制需要改进。正在实施 connection_pool.py 包含确定Docker MCP Toolkit如何提供对已运行服务器的访问后需要实现的placeholder。

实施选项：

1. 完成Docker MCP工具包网关API
2. 通过STDIO直接连接到容器
3. 使用SSE/Streaming Transport

代理功能

与运行的服务器的所有通信都通过Orchestrator代理进行。AI应该使用 call_tool() 调用工具，而不是试图直接调用它们。

______________________________________________________________________

📚 文件

• ARCHITECTURE_V2.md -详细的系统架构
• 实施_PLAN_V2.md -实施计划
• 部署.md -部署指示
• Docker MCP Toolkit命令列表
• promises/ai_rules.md -与Orchestrator合作的AI规则

______________________________________________________________________

🐛 已知问题

1. 连接池：需要实现服务器连接机制
2. MCP API：返回值的格式可能需要根据库的MCP版本进行调整

______________________________________________________________________

📄 许可证

MIT许可证

______________________________________________________________________

🤝 贡献

欢迎贡献！请创建问题或推送请求以获取建议和更正。

______________________________________________________________________

📞 支持

如果出现问题：

1. 检查 部署.md 部署说明
2. 检查自述中的疑难解答部分
3. 在GitHub存储库中创建一个问题