AI导哈

MCP代码库设置工具

用于在WSL Ubuntu 24.04环境中安装和验证常用MCP（Model Context Protocol）的工具集，包含自动化脚本、API指南和配置模板。

  • by zapprosite
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 zapprosite/mcp-codex

使用说明

MCP Codex Setup — 2025 年 11 月

完整的结构，用于安装和验证Ubuntu 24.04 WSL（Trae IDE）中使用Codex CLI的最常用MCP。包括初始提示符、 模板 .env，TOML配置，自动化脚本和API指南。

先决条件

  • Node.js 18+e npm没有WSL。
  • Codex CLI全球安装(npm i -g @smithery-ai/codex-cli).
  • 访问集成密钥：GitHub，Brave Search，Exa，Context7，Playwright（可选），Obsidian（可选）。 对于模型，在Codex/Trae中使用OAuth登录（无 OPENAI_*).

快速步骤

  1. 阅读 PROMPT.md 如果您想通过 Codex CLI 生成结构，请运行主提示符。
  2. 复制模板 ： cp .env.example .env 你骑马了 python scripts/setup-apis.py 以互动方式填充。
  3. 全部安装为 bash scripts/install_mcps.sh.
  4. 通过验证配置 python3 scripts/test-mcps.py.
  5. 咨询 docs/API-SETUP-GUIDE.md 凭据详细信息和 docs/MCP-USAGE-GUIDE.md 使用例子。

内容

  • codex-config.toml已参数化的 16 个 MCP （10 个主要 + 6 个额外的） 列表。
  • scripts/install_mcps.sh：通过npm安装MCP（前缀 .mcp/），复制 config 并检查 Codex CLI。
  • scripts/setup-apis.py: 填写向导 .env轻松验证密钥。
  • scripts/test-mcps.py：罗达 codex mcp list/info 并用问题标记 MCP。
  • docs/API-SETUP-GUIDE.md生成每个密钥/令牌的官方链接。
  • docs/MCP-USAGE-GUIDE.md：建议用于日常调试和使用的命令。

包含的 MCP

  • sequential-thinking — @modelcontextprotocol/server-sequential-thinking
  • shell — @mkusaka/mcp-shell-server
  • github — @modelcontextprotocol/server-github
  • brave-search — @brave/brave-search-mcp-server
  • web-research — @mzxrai/mcp-webresearch
  • task-manager — @kazuph/mcp-taskmanager
  • sqlite — mcp-server-sqlite-npx
  • fetch — @mokei/mcp-fetch
  • memory — @iachilles/memento
  • playwright — @executeautomation/playwright-mcp-server
  • filesystem — @modelcontextprotocol/server-filesystem
  • desktop-commander — @wonderwhy-er/desktop-commander
  • exa-search — exa-mcp
  • obsidian — mcp-obsidian
  • context7 — @upstash/context7-mcp
  • git — @cyanheads/git-mcp-server

注释 ： @modelcontextprotocol/server-github 在 npm 中标记为 deprecated，但仍然可用（上次检查时间为 2025 年 11 月 3 日）。服务器 fetch Python （mcp-server-fetch因此，我们使用包 @mokei/mcp-fetch 保持基于npm的流。

建议的下一步

  • 完成后修改工程版本 .env （保证 .env 在 .gitignore).
  • 安排定期密钥审查（旋转敏感令牌）。
  • 调整器 codex-config.toml 如果需要启用/禁用特定的 MCP（例如： iterm-mcp 没有macOS）。

Trae IDE 与 Codex CLI 隔离

  • 目标：在同一台 PC 上使用 Trae IDE 和 Codex CLI 时，避免 MCP 和变量之间的冲突。
  • 如何保持隔离：
    • Codex CLI
      • 美国 ~/.codex/config.toml 以及安装在本地前缀中的软件包 .mcp/ 从项目。
      • 装入 .env 只有在Codex scripts/codex-env.ps1:
        • ./scripts/codex-env.ps1 codex mcp list
        • ./scripts/codex-env.ps1 python scripts/test-mcps.py
      • 建议使用 WSL 上的 LTS 20 节点（根据先决条件）。
    • 带来IDE
      • 直接在 Trae 中配置每个 MCP，并将软件包安装在单独的目录中（例如： C:\Users\<user>\.trae\mcp).
      • 首选通过运行 node.exe （Node 20 的绝对路径）指向 dist/index.js 而不是MCP npx.
      • 在 Trae 中通过 MCP 定义环境变量，而不依赖于 .env 从项目。
  • 优势：
    • 不共享缓存 npx Trae和Codex之间的依赖关系。
    • 令牌和密钥是分开的；哦 .env 只影响 Codex 进程。
    • 减少错误如 ERR_MODULE_NOT_FOUND em缓存可以 npx Node版本冲突。

相关 MCP