MCP Manager

Windows 上的 MCP 图形化安装和管理工具。用户下载 Release 里的 mcp-manager.exe 后，双击即可用 UI 把热门 MCP 服务写入 Codex CLI 和 Claude Code 配置。

功能

• 图形界面管理 MCP：搜索、勾选、查看中文简介和推荐指数、填写 API Key/路径/连接串、安装、移除、查看状态。
• 支持 Codex CLI 和 Claude Code，可选择 both、codex、claude。
• 自动适配配置方式：优先调用 codex mcp / claude mcp 官方命令，缺失时在可安全处理的位置直接写配置。
• 内置热门 MCP 清单：Filesystem、Memory、Sequential Thinking、Playwright、Chrome DevTools、Puppeteer、Context7、GitHub、GitLab、Notion、Sentry、DBHub、Postgres、Excel、PPT Generator、Airtable、Slack、Brave Search、Tavily、Firecrawl、21st.dev Magic。
• 支持 Windows 常见 PowerShell 执行策略限制：内部优先调用 .cmd / .exe，避免被 .ps1 拦截。
• 可检查基础依赖：doctor 会检查 Windows、Node.js、npx、Codex CLI、Claude Code。
• MIT 协议。

快速使用

双击 mcp-manager.exe 或源码目录里的 start.bat，即可打开图形界面。

mcp-manager.exe

高级用户可使用 mcp-manager-cli.exe 或 start.bat 参数模式运行命令行子命令：

mcp-manager-cli.exe list
.\start.bat list

给 Codex 和 Claude Code 同时安装 Memory 与 Context7：

mcp-manager-cli.exe install memory context7 --client both

给 Codex 安装本地文件系统 MCP：

mcp-manager-cli.exe install filesystem --client codex --set MCP_FS_ROOT=C:\Users\you\Documents

给 Claude Code 的项目级配置安装 Playwright：

mcp-manager-cli.exe install playwright --client claude --scope project --project-dir C:\path\to\repo

移除 MCP：

mcp-manager-cli.exe remove memory --client both

查看已配置 MCP：

mcp-manager-cli.exe status --client both

检查环境：

mcp-manager-cli.exe doctor
mcp-manager-cli.exe doctor --fix

配置策略

Codex:

• 优先调用 codex mcp add/remove。
• 如果找不到 Codex CLI，可直接写入 %USERPROFILE%\.codex\config.toml 的 [mcp_servers.<name>] 配置块。

Claude Code:

• 优先调用 claude mcp add-json/remove，支持 local、user、project scope。
• 如果找不到 Claude Code CLI，仅支持直接写项目级 .mcp.json。

开发

python -m pip install -e .
python -m mcp_installer list
python -m unittest discover -s tests

构建 Windows 单文件 exe：

.\build.ps1 -Clean

如果本机 PowerShell 禁止运行脚本：

powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1 -Clean

构建产物位于：

dist\mcp-manager.exe
dist\mcp-manager-cli.exe

发布到 GitHub

1. 在 GitHub 创建一个空仓库，例如 mcp-manager。
2. 本地初始化并推送：

git init
git add .
git commit -m "Initial release"
git branch -M main
git remote add origin https://github.com/<your-name>/mcp-manager.git
git push -u origin main

3. 创建版本标签后推送，GitHub Actions 会自动构建 exe 并附加到 Release：

git tag v0.1.0
git push origin v0.1.0

参考

• Codex MCP 命令：codex mcp --help
• Claude Code MCP 命令：claude mcp --help
• Claude Code MCP 文档：https://docs.anthropic.com/en/docs/claude-code/mcp
• Codex 配置参考：https://developers.openai.com/codex/config-reference