运行 AgentTorch MCP 服务器

本指南介绍如何使用 Docker 在本地以及通过 Claude Desktop 集成来运行 AgentTorch MCP 服务器。

选项 1：在本地使用 Docker 运行

前提条件

• 您的机器上已安装 Docker
• 您的机器上已安装 Docker Compose
• 您的机器上已安装 Git

步骤 1：克隆存储库

git clone https://github.com/AgentTorch/mcp-server
cd mcp-server

步骤 2：设置环境变量文件

在项目根目录中创建一个 .env 文件，其中包含您的 Anthropic API 密钥：

# 创建 .env 文件
cat > .env << 'EOL'
ANTHROPIC_API_KEY=api_key
PYTHONPATH=/app
AGENTTORCH_CONFIG_PATH=/app/config.yaml
EOL

步骤 3：使用 Docker Compose 启动

# 启动容器
docker-compose up -d

# 检查容器是否正在运行
docker-compose ps

# 查看日志
docker-compose logs -f

步骤 4：访问 Web UI

打开您的浏览器并访问：

http://localhost:8080

步骤 5：在本地运行 MCP 服务器

您可以使用以下命令与容器化的 MCP 服务器进行交互：

# 直接在容器中执行服务器
docker exec -it agenttorch-mcp mcp run server.py

选项 2：Claude Desktop 集成

步骤 1：创建所需文件

确保您已完成上述选项 1 中的步骤 1-3，以使 Docker 容器运行。

步骤 2：配置 Claude Desktop

创建或更新 Claude Desktop 配置：

1. 找到您的 Claude Desktop 配置目录：

   • macOS: ~/.claude-desktop/
   • Windows: %APPDATA%\claude-desktop\
   • Linux: ~/.config/claude-desktop/

2. 创建或编辑 config.json 文件：

# 对于 macOS/Linux
mkdir -p ~/.claude-desktop
cat > ~/.claude-desktop/config.json << 'EOL'
{
  "mcpServers": {
    "AgentTorch Simulator": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "agenttorch-mcp",
        "mcp",
        "run",
        "server.py"
      ]
    }
  }
}
EOL

# 对于 Windows (使用 PowerShell)
# New-Item -Path "$env:APPDATA\claude-desktop" -ItemType Directory -Force
# Set-Content -Path "$env:APPDATA\claude-desktop\config.json" -Value '{
#   "mcpServers": {
#     "AgentTorch Simulator": {
#       "command": "docker",
#       "args": [
#         "exec",
#         "-it",
#         "agenttorch-mcp",
#         "mcp",
#         "run",
#         "server.py"
#       ]
#     }
#   }
# }'

步骤 3：启动 Claude Desktop

1. 打开 Claude Desktop
2. 您应该在服务器选择下拉列表中看到“AgentTorch Simulator”
3. 选择它以连接到您的 Docker 容器

步骤 4：测试集成

1. 在 Claude Desktop 中开始一个新的对话
2. 选择一个可用的提示（例如，“Run Simulation”）
3. 输入一个查询，例如“Run a simulation with 500 predators and 1000 prey”
4. 检查 Claude Desktop 和 Web UI (http://localhost:8080) 的结果

故障排除

Docker 问题

# 重启容器
docker-compose restart

# 重新构建容器（如果您进行了更改）
docker-compose down
docker-compose up -d --build

# 检查容器日志
docker-compose logs -f

Claude Desktop 连接问题

1. 验证 Docker 容器是否正在运行：

   docker ps | grep agenttorch-mcp
   

2. 检查容器是否可以执行 MCP 命令：

   docker exec -it agenttorch-mcp mcp list
   

3. 重启 Claude Desktop

Web UI 问题

1. 检查 HTTP 服务器是否正在运行：

   docker exec -it agenttorch-mcp curl http://localhost:8080
   

2. 检查端口映射：

   docker-compose ps
   

容器管理命令

# 停止容器
docker-compose stop

# 启动容器
docker-compose start

# 删除容器（保留您的数据）
docker-compose down

# 删除容器和卷（删除您的数据）
docker-compose down -v

# 查看容器资源使用情况
docker stats