如何在 E2B 沙箱中运行 GitHub 与 Notion MCP 服务器并让代理经 MCP Gateway 调用工具
如何在 E2B 沙箱中运行 GitHub 与 Notion MCP 服务器并让代理经 MCP Gateway 调用工具
本文章对应 Nebius-Cookbook 仓库中 mcp_ai_agents/e2b_docker_mcp_agent 演示项目要完成的任务:在一个 E2B 沙箱里启动 GitHub 与 Notion 两个 MCP(Model Context Protocol)服务器,然后用 OpenAI Agents SDK 通过 E2B 的 MCP Gateway 以 HTTP 方式连接这两个服务器,让 AI 代理调用其中的工具,自动完成一个跨 GitHub 与 Notion 的示例任务——列出你的 GitHub 仓库,并在 Notion 中创建一个汇总按 star 数排名前 3 仓库的页面。运行环境要求 Python 3.13+ 与 uv 包管理器,模型调用走 Nebius Token Factory。
准备工作:密钥与运行环境
根据 README 的 Prerequisites 部分,需要准备以下运行环境与凭据:
- Python 3.13+(pyproject.toml 中
requires-python = ">=3.13"与此一致) - uv 包管理器(按 uv 官方安装说明安装)
- E2B API key,在 E2B 控制台获取
- OpenAI API key
- GitHub Personal Access Token,所需权限范围(scopes)为
repo、read:user、read:org - Notion Integration Token;注意 Notion 页面和数据库必须共享(share)给你的集成,否则 MCP 服务器无法访问
- Nebius API key,用于模型推理(main.py 启动时会校验
NEBIUS_API_KEY,缺失时直接抛出ValueError)
安装依赖与配置环境变量
进入 mcp_ai_agents/e2b_docker_mcp_agent 目录后,先用 uv 安装依赖:
uv sync
依赖来自 pyproject.toml,包括 e2b>=2.3.4、python-dotenv>=1.1.1、openai-agents>=0.1.0。
然后在项目根目录创建 .env 文件,填入以下密钥(把占位值替换为你自己的真实密钥):
E2B_API_KEY=your_e2b_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
NOTION_TOKEN=your_notion_integration_token_here
GITHUB_TOKEN=your_github_personal_access_token_here
NEBIUS_API_KEY=your_nebius_api_key_here
main.py 开头通过 dotenv.load_dotenv() 加载这个文件,并从中读取 NOTION_TOKEN、GITHUB_TOKEN 等值;代码中 EXAMPLE_MODEL_NAME 和 EXAMPLE_BASE_URL 两个变量是可选覆盖项,用于切换模型名与推理端点(见下文说明)。
创建沙箱并配置两个 MCP 服务器
main.py 的核心流程分为三步。
第一步,实例化两个 MCP 服务器并打包进 McpServer 配置:
notion = Notion(internalIntegrationToken=notion_api_key)
github = GithubOfficial(githubPersonalAccessToken=github_token)
mcp_servers = McpServer(notion=notion, githubOfficial=github)
Notion 与 GithubOfficial 来自 e2b.sandbox.mcp 模块,构造时分别传入 Notion 集成令牌和 GitHub Personal Access Token。
第二步,用 Sandbox.beta_create 创建带 MCP 服务器配置的沙箱:
sandbox = Sandbox.beta_create(
envs={"OPENAI_API_KEY": openai_api_key}, mcp=mcp_servers, timeout=600
)
其中 mcp 参数决定沙箱内启动的 MCP 服务器;timeout=600 是沙箱存活超时(秒);envs 向沙箱环境注入 OpenAI API key。
第三步,取得 MCP Gateway 的连接信息:
mcp_url = sandbox.beta_get_mcp_url()
mcp_token = sandbox.beta_get_mcp_token()
mcp_url 是 E2B MCP Gateway 的 HTTP 地址,mcp_token 是访问它的 Bearer 令牌。GitHub 与 Notion MCP 服务器由 MCP Gateway 统一以 HTTP 方式对外暴露,代理不直接连接两个服务器本身。
通过 MCP Gateway 连接并让代理调用工具
代理侧用 OpenAI Agents SDK 的 MCPServerStreamableHttp 连接 Gateway:
async with MCPServerStreamableHttp(
name="E2B MCP Gateway",
params={
"url": mcp_url,
"headers": {"Authorization": f"Bearer {mcp_token}"},
"timeout": 180,
},
cache_tools_list=True,
max_retry_attempts=2,
) as server:
tools = await server.list_tools()
连接参数说明:url 与 headers 取自上一步的 beta_get_mcp_url() / beta_get_mcp_token();timeout: 180 是本次连接层的超时秒数;cache_tools_list=True 表示缓存工具列表;max_retry_attempts=2 是重试次数。
连接建立后,server.list_tools() 会列出 Gateway 暴露的全部工具,也就是 GitHub 与 Notion 两个 MCP 服务器各自的工具集合。随后创建代理并绑定这个 MCP 服务器:
agent = Agent(
model=model,
name="GitHub and Notion Assistant",
instructions="...",
mcp_servers=[server],
)
模型通过 OpenAIChatCompletionsModel 连接 Nebius Token Factory:默认模型名为 moonshotai/Kimi-K2-Instruct,默认端点为 https://api.tokenfactory.nebius.com/v1,用 NEBIUS_API_KEY 作为 API key;如需换模型,可通过环境变量 EXAMPLE_MODEL_NAME 与 EXAMPLE_BASE_URL 覆盖默认值。
最后执行示例任务:
result = await Runner.run(agent, task)
task 是自然语言指令:先用 GitHub MCP 服务器列出仓库,再用 Notion MCP 服务器搜索一个可用的父页面,然后创建一个标题类似 "Top GitHub Repositories" 的页面,用 paragraph 块列出 star 数前 3 的仓库(名称、stars、描述)。README 提示创建 Notion 页面时保持简单的纯文本结构,遇到格式错误时换更简单的格式重试。
运行演示并核对结果
uv run main.py
按 README 的 What It Does 描述,一次正常运行会依次发生以下事情,可以据此核对:
- 控制台打印 OpenAI key 加载信息、
MCP Gateway URL与 MCP token 前缀; - 打印
Available tools (N):,并列出前 10 个工具的名称与描述开头——这能确认 Gateway 已把 GitHub 与 Notion 两个 MCP 服务器的工具暴露出来; - 代理执行任务后打印分隔线与
Agent Result:,内容为result.final_output; - 若代理返回了 usage 信息,会额外打印用量统计;
- 无论任务成功与否,
finally块都会调用sandbox.kill()清理沙箱,控制台出现Sandbox terminated.(清理失败时打印Warning: Error terminating sandbox: ...)。
最终的可见结果:GitHub 仓库列表被拉取,Notion 中出现一个汇总 star 数前 3 仓库的新页面。若中途发生异常,代码会打印 ❌ Error: ... 并附带 traceback。
限制与注意事项
- 沙箱有 600 秒超时,整个任务需在该窗口内完成;连接层另有 180 秒的 HTTP 超时。
- GitHub token 必须包含
repo、read:user、read:org三个 scope,缺 scope 会导致 GitHub 相关工具调用失败。 - Notion 集成必须先在 Notion 端共享页面和数据库,README 将其列为前置条件。
- 模型端点与模型名以
NEBIUS_API_KEY对应的 Nebius Token Factory 为准,main.py在未设置该变量时不会继续运行。 - 更完整的背景资料可参考 README 的 References 一节以及 main.py 的完整源码。