使用说明
项目简介
e2b-mcp 服务器是一个 MCP (Model Context Protocol) 服务器实现,它集成了 E2B (Ephemeral Environments for Builders) 的安全沙箱技术。该服务器主要功能是为大型语言模型 (LLM) 客户端提供一个名为 'run_code' 的工具,允许 LLM 通过调用此工具在安全的 E2B 沙箱环境中执行 Python 代码。这使得 LLM 能够安全地运行代码片段,获取执行结果,从而扩展 LLM 的能力边界,例如进行数据分析、逻辑推理等需要代码执行的复杂任务。
主要功能点
- 代码执行工具: 提供 'run_code' 工具,允许 LLM 客户端提交 Python 代码并在 E2B 沙箱中执行。
- 安全沙箱环境: 利用 E2B 提供的安全沙箱隔离代码执行环境,确保安全性和隔离性。
- MCP 协议支持: 遵循 Model Context Protocol 标准,与兼容 MCP 协议的 LLM 客户端进行通信。
- 易于集成: 提供简单的安装和配置步骤,方便集成到支持 MCP 协议的 LLM 客户端,如 Claude Desktop。
安装步骤
-
安装依赖: 在项目根目录下,打开终端并执行以下命令安装项目依赖:
npm install -
构建服务器: 执行以下命令构建服务器代码:
npm run build
服务器配置
要将 e2b-mcp 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动配置信息。以下是针对 Claude Desktop 的配置示例,您需要根据您的实际环境进行调整。
找到 Claude Desktop 的配置文件 'claude_desktop_config.json',通常位于:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
在 'mcpServers' 字段中添加或修改 'e2b-server' 的配置。如果 'mcpServers' 字段不存在,请创建它。
{ "mcpServers": { "e2b-server": { "command": "node", "args": [ "<e2b-mcp 项目的绝对路径>/js/build/index.js" ], "env": { "E2B_API_KEY": "<您的 E2B API 密钥>" } } } }
配置参数说明:
- '"e2b-server"': 服务器名称,您可以自定义,客户端通过此名称识别服务器。
- '"command": "node"': 启动服务器的命令,这里使用 Node.js 运行环境。
- '"args"': 启动命令的参数,指向构建后的 'index.js' 文件路径。请务必将 '<e2b-mcp 项目的绝对路径>' 替换为您本地 e2b-mcp 项目的实际绝对路径。
- '"env"': 环境变量配置。
- '"E2B_API_KEY"': 必须配置您的 E2B API 密钥。 您需要在 E2B 官网 获取 API 密钥。
基本使用方法
配置完成后,当您在 Claude Desktop 等 MCP 客户端中使用时,客户端将能够发现并调用 e2b-mcp 服务器提供的 'run_code' 工具。
例如,在 Claude 中,您可以指示模型执行 Python 代码,模型将通过 MCP 协议调用 e2b-mcp 服务器的 'run_code' 工具,并将代码发送到服务器执行。服务器会在 E2B 沙箱中运行代码,并将执行结果返回给客户端,最终由 Claude 呈现给用户。
注意: 您需要确保已在 'e2b.toml' 和 'src/index.ts' 文件中修改为您自己的 E2B sandbox template ID。
信息
分类
AI与计算