使用说明

项目简介

这是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供代码执行功能。通过注册 "run-code" 工具，该服务器允许连接的 MCP 客户端（如支持 MCP 协议的 LLM 应用）执行指定编程语言的代码片段，并返回代码的执行结果。这使得 LLM 能够动态地运行代码，从而增强其处理计算密集型或需要实时代码执行任务的能力。

主要功能点

代码执行: 提供 "run-code" 工具，允许执行多种编程语言的代码片段。
多语言支持: 支持包括 JavaScript, Python, Java, Go 等多种常用编程语言（具体支持语言列表请参考仓库中的 'constants.ts' 文件）。
结果返回: 将代码执行的结果以文本形式返回给 MCP 客户端。
易于集成: 可以通过标准的 MCP 协议与各种 LLM 客户端集成，例如 VS Code 和 Claude Desktop。

安装步骤

该 MCP 服务器可以直接通过 'npx' 命令运行，无需复杂的安装步骤。

确保 Node.js 和 npm 已安装: 如果您的机器上尚未安装 Node.js 和 npm，请先安装。
运行服务器: 在您的终端中，使用 'npx mcp-server-code-runner' 命令即可启动服务器。

服务器配置

MCP 服务器是为 MCP 客户端提供服务的后端应用。您需要在您的 MCP 客户端应用中配置连接到此服务器的信息。以下是针对不同 MCP 客户端的配置示例：

针对 VS Code 的配置 (添加到 VS Code 的 'settings.json' 文件):

{
  "mcp": {
    "inputs": [],
    "servers": {
      "mcp-server-code-runner": {  // 服务器名称，可以自定义
        "command": "npx",        // 启动服务器的命令
        "args": [                 // 启动服务器命令的参数
          "-y",
          "mcp-server-code-runner"
        ]
      }
    }
  }
}

针对 Claude Desktop 的配置 (添加到 'claude_desktop_config.json' 文件):

{
  "mcpServers": {
    "mcp-server-code-runner": {  // 服务器名称，可以自定义
      "command": "npx",        // 启动服务器的命令
      "args": [                 // 启动服务器命令的参数
        "-y",
        "mcp-server-code-runner"
      ]
    }
  }
}

配置说明:

'"mcp-server-code-runner"': 服务器的名称，在客户端配置中用于标识和引用该服务器。您可以自定义此名称。
'"command": "npx"': 指定用于启动服务器的可执行命令。 'npx' 通常用于运行 npm 包的可执行文件。
'"args": [...]': 包含传递给 'command' 命令的参数。 '"-y", "mcp-server-code-runner"' 表示 'npx' 将执行 'mcp-server-code-runner' 这个 npm 包。

请注意: 确保您的 MCP 客户端应用已正确配置并能读取上述 JSON 配置文件。具体的配置文件位置和格式可能因 MCP 客户端而异，请参考您使用的 MCP 客户端的文档。

基本使用方法

配置完成后，在您的 LLM 应用中，您可以使用自然语言指令来触发代码执行。例如：

在支持 MCP 协议的应用中，输入类似 'Run the JS Code: console.log(5+6)' 的提示，服务器将执行 JavaScript 代码 'console.log(5+6)' 并返回执行结果。
您可以尝试执行其他支持的编程语言的代码，只需在提示中指明语言和代码内容。

服务器将尽力执行代码并返回结果。如果执行过程中出现错误，服务器会将错误信息返回给客户端。

关键词