关键词

代码执行PythonDocker沙箱工具调用

项目简介

Python Run MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，专注于提供安全、隔离的 Python 代码执行环境。它通过 Docker 容器技术，允许 LLM 客户端调用工具来执行 Python 代码，并返回执行结果。

主要功能点

  • 安全的代码执行: 使用 Docker 容器隔离执行 Python 代码，防止恶意代码影响服务器或宿主机环境。
  • 工具注册与调用: 实现了 MCP 的工具注册和调用机制，客户端可以通过标准化的 MCP 协议调用 'run_python' 工具。
  • 动态环境配置: 支持在 Docker 容器中安装指定的 Python 包依赖，满足不同代码执行的需求。
  • 标准 MCP 协议: 遵循 Model Context Protocol (MCP) 规范，易于与各种 MCP 客户端集成。

安装步骤

  1. 安装依赖:
    在项目根目录下，运行以下命令安装 Python 依赖：

    pip install -r requirements.txt

    前提条件: 确保你的系统已安装 'pip' 和 'Docker'。

  2. 启动服务器:
    在项目 'src' 目录下，运行以下命令启动 MCP 服务器：

    python src/server.py

    服务器默认监听标准输入和标准输出 (stdio)，等待 MCP 客户端连接。

服务器配置 (MCP 客户端配置)

MCP 客户端需要配置以下信息以连接到 Python Run MCP Server：

{
  "serverName": "python-run-mcp",
  "command": "python",
  "args": ["src/server.py"]
}
  • 'serverName': 服务器名称，设置为 'python-run-mcp'。
  • 'command': 启动服务器的命令，设置为 'python'。
  • 'args': 启动服务器命令的参数，设置为 '["src/server.py"]'，指向服务器脚本路径。

注意: 请确保 Docker 服务已在运行，并且执行 'python src/server.py' 命令的用户有 Docker 运行权限。

基本使用方法

  1. 启动 MCP 客户端: 配置 MCP 客户端连接到 Python Run MCP Server。

  2. 客户端发送请求: 客户端可以发送 MCP 请求调用 'run_python' 工具，例如：

    {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "call_tool",
    "params": {
        "name": "run_python",
        "arguments": {
            "code": "print('Hello from MCP Server!')"
        }
    }
}

    将上述 JSON 请求通过 MCP 客户端发送到服务器。

  3. 服务器返回响应: 服务器执行 Python 代码，并将执行结果以 MCP 响应格式返回给客户端。

开发者信息: 仓库作者为 topherbc，项目基于 Python 和 Docker 构建，采用 MIT 许可证。

信息

分类

AI与计算

访问项目