如何在 E2B 沙箱中运行 GitHub 与 Notion MCP 服务器并让代理经 MCP Gateway 调用工具

原创2026-09-14 10:23:161,604 阅读
文章标签:示例工程人工智能AI 应用

如何在 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 描述,一次正常运行会依次发生以下事情,可以据此核对:

  1. 控制台打印 OpenAI key 加载信息、MCP Gateway URL 与 MCP token 前缀;
  2. 打印 Available tools (N):,并列出前 10 个工具的名称与描述开头——这能确认 Gateway 已把 GitHub 与 Notion 两个 MCP 服务器的工具暴露出来;
  3. 代理执行任务后打印分隔线与 Agent Result:,内容为 result.final_output;
  4. 若代理返回了 usage 信息,会额外打印用量统计;
  5. 无论任务成功与否,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 的完整源码。
登录后查看全文
Nebius-Cookbook