AI导哈

AI代理执行服务

一个提供AI代理核心执行能力的Docker容器化服务，支持多语言代码执行、包管理和安全控制。

  • by realugbun
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 realugbun/AgentExecMCP

使用说明

Agent ExecMCP

FastMCP服务器为AI代理提供核心执行功能，打包在Docker中，便于安全和轻松部署。

⚡ 快速开始

在2分钟内起床并跑步：请参阅 QUICKSTART.md.

📋 目录

🚀 特性

  • 壳牌执行：运行带有超时和安全控制的bash命令
  • 多语言代码执行：Python、Node.js和Go支持，执行优化
  • 包管理：通过pip、npm和go模块安装软件包
  • 多个传输：stdio和SSE
  • Docker部署：容器化以实现一致的执行环境
  • MCP协议：符合标准的模型上下文协议
  • 安全控制：非根执行、超时、并发限制
  • Claude桌面集成：通过SSE传输与Claude Desktop无缝协作
  • Go优化：使用CGO_ENABLED=0执行Go代码以提高兼容性

🛠️ 发出命令

AgentExecMCP包含一个全面的Makefile，使设置和管理变得超级简单。所有命令的设计都是为了方便技术和非技术用户使用。

快速启动命令

make help                # Show all available commands with descriptions
make quick-start         # Build and run with SSE transport (recommended)

核心命令

make build              # Build the Docker container
make run                # Run with STDIO transport (interactive)
make run-sse            # Run with SSE transport (for Claude Desktop)

管理命令

make status             # Show container status
make logs               # Show container logs (follows log output)
make health             # Check if server is responding
make stop               # Stop all running containers
make shell              # Open shell in running container

开发命令

make lint               # Run ruff linter and formatter

维护命令

make test               # Test basic functionality
make clean              # Remove containers and images
make workspace          # Create workspace directory

工作流示例

# First time setup
make quick-start                    # Builds and starts everything
make install-claude-config          # Sets up Claude Desktop

# Daily usage
make status                         # Check if running
make logs                          # View output
make stop                          # Stop when done

# Troubleshooting
make clean                         # Clean everything
make quick-start                   # Fresh start

🖥️ Claude桌面集成

AgentExecMCP使用SSE传输与Claude Desktop无缝协作。这非常适合本地开发和测试。

使用Make轻松设置（推荐）

超级简单的3步设置：

  1. 启动AgentExecMCP：

    make quick-start

  2. 安装Claude桌面配置：

    make install-claude-config

  3. 重新启动克劳德桌面 并寻找MCP工具图标！ 🎉

手动设置（如果您愿意）

  1. 启动SSE服务器：

    docker run -d --name AgentExecMCP-claude -p 8000:8000 -e MCP_TRANSPORT=sse AgentExecMCP

  2. 配置Claude桌面：

    打开您的Claude Desktop配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%\Claude\claude_desktop_config.json

    添加以下配置：

    {
  "mcpServers": {
    "AgentExecMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/sse"
      ]
    }
  }
}

  3. 重新启动克劳德桌面 并查找MCP工具图标

测试集成

在Claude Desktop中尝试以下命令：

  • “运行shell命令列出文件”
  • “执行一些Python代码来计算2+2”
  • “使用pip安装请求包”

故障排除

  • 检查服务器状态: make status
  • 查看日志: make logs
  • 重新启动服务器: make stop && make quick-start

Claude Desktop的先决条件

  • Node.js和npm 安装在您的系统上
  • 码头工人 使用AgentExecMCP容器运行
  • 克劳德桌面版 最新版本

这 mcp-remote 首次使用时，npx会自动安装该包。

🖥️ 光标集成

AgentExecMCP与 光标 IDE使用与Claude Desktop相同的SSE传输和配置。

手动设置（光标）

  1. 启动SSE服务器：

    make quick-start

  2. 配置光标：

    打开Cursor mcp配置文件（例如 ~/.cursor/mcp.json)并添加以下内容：

    {
  "mcpServers": {
    "AgentExecMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/sse"
      ]
    }
  }
}

🔧 MCP工具

1.外壳工具

执行带有安全控制的shell命令。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "shell",
    "arguments": {
      "request": {
        "command": "echo 'Hello World!'",
        "timeout": 60,
        "cwd": "/workspace"
      }
    }
  }
}

2.执行代码工具

在Python、Node.js或Go中运行代码片段，并优化执行。

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "execute_code",
    "arguments": {
      "request": {
        "language": "python",
        "code": "print('Hello from Python!')\nprint(2 + 2)",
        "timeout": 60
      }
    }
  }
}

Go代码示例：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "execute_code",
    "arguments": {
      "request": {
        "language": "go",
        "code": "package main\nimport \"fmt\"\nfunc main() {\n    fmt.Println(\"Hello from Go!\")\n}",
        "timeout": 60
      }
    }
  }
}

特征：

  • python：具有标准库的完整Python 3.x环境
  • Node.js：使用npm包的Node.js运行时
  • 去：使用CGO_ENABLED=0优化执行，以获得更好的兼容性
  • 自动清理：临时文件会自动创建和清理
  • 错误处理：正确捕获编译和运行时错误

3.安装软件包工具

使用各种包管理器安装包。

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "install_package",
    "arguments": {
      "request": {
        "package_manager": "pip",
        "package": "requests",
        "version": "2.32.0"
      }
    }
  }
}

🌐 客户端连接示例

FastMCP客户端（Python）

from fastmcp import Client
import asyncio

async def main():
    # Connect via stdio to local container
    async with Client("docker run -i --rm AgentExecMCP") as client:
        result = await client.call_tool("shell", {"request": {"command": "echo 'Hello!'"}})
        print(result[0].text)
    
    # Connect via SSE to HTTP server
    async with Client("http://localhost:8000/sse") as client:
        tools = await client.list_tools()
        print(f"Available tools: {[tool.name for tool in tools]}")

asyncio.run(main())

🔒 安全特性

  • 非根执行：运行方式 agent 用户（UID 10001）
  • 沙盒工作空间：所有操作 /workspace 目录
  • 超时控制：可配置超时（默认60秒，最大300秒）
  • 并发限制：最多4个并发进程
  • 输入验证：尺寸限制和参数验证
  • 流程清理：自动清理正在运行的进程

🌍 环境

集装箱包括：

  • Ubuntu 22.04 基本图像
  • Python 3.13.3 使用pip包管理器
  • Node.js 20.19.2 使用npm
  • 转到1.23.4 带模块
  • 开发工具：git、curl、wget、build essential
  • 公用事业：jq、ripgrep、fd查找、htop

📡 MCP协议支持

服务器实现了具有多种传输选项的模型上下文协议（MCP）2024-11-05规范：

  • 工作室：本地工具和命令行使用的默认传输
  • 上海证券交易所：用于HTTP部署和Claude Desktop的服务器发送事件传输

🛠️ 发展

地方发展

# Install dependencies
uv sync

# Run server locally (stdio)
uv run python -m app.main

# Run server with SSE transport
MCP_TRANSPORT=sse uv run python -m app.main

测试

服务器已通过以下测试：

  • ✅ 所有传输的MCP协议合规性
  • ✅ 所有三个工具（shell、execute_code、install_package）
  • ✅ 通过包导入执行多语言代码
  • ✅ 包装安装和验证
  • ✅ Docker容器部署
  • ✅ 通过SSE传输集成Claude Desktop
  • ✅ 安全和超时控制

📋 需求

  • Docker（用于容器化部署）
  • Python 3.12+（用于本地开发）
  • UV包管理器（用于依赖关系管理）
  • Node.js和npm（用于Claude Desktop集成）

🎯 用例

  • Claude桌面集成：直接在Claude Desktop中提供执行功能
  • AI代理执行：为AI代理提供安全的执行环境
  • 代码沙盒：在隔离容器中运行不受信任的代码
  • 多语言开发：支持Python、Node.js和Go工作流
  • 包管理：跨生态系统安装和测试软件包
  • 壳牌自动化：通过适当的控制执行系统命令
  • Kubernetes部署：扩展云环境中的执行能力

📄 许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

该项目遵循快速构建、可复制、默认安全和可扩展的指导原则。

相关 MCP