内容
# 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`，即可打开图形界面。
```powershell
mcp-manager.exe
```
高级用户可使用 `mcp-manager-cli.exe` 或 `start.bat` 参数模式运行命令行子命令：
```powershell
mcp-manager-cli.exe list
.\start.bat list
```
给 Codex 和 Claude Code 同时安装 Memory 与 Context7：
```powershell
mcp-manager-cli.exe install memory context7 --client both
```
给 Codex 安装本地文件系统 MCP：
```powershell
mcp-manager-cli.exe install filesystem --client codex --set MCP_FS_ROOT=C:\Users\you\Documents
```
给 Claude Code 的项目级配置安装 Playwright：
```powershell
mcp-manager-cli.exe install playwright --client claude --scope project --project-dir C:\path\to\repo
```
移除 MCP：
```powershell
mcp-manager-cli.exe remove memory --client both
```
查看已配置 MCP：
```powershell
mcp-manager-cli.exe status --client both
```
检查环境：
```powershell
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`。
## 开发
```powershell
python -m pip install -e .
python -m mcp_installer list
python -m unittest discover -s tests
```
构建 Windows 单文件 exe：
```powershell
.\build.ps1 -Clean
```
如果本机 PowerShell 禁止运行脚本：
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1 -Clean
```
构建产物位于：
```text
dist\mcp-manager.exe
dist\mcp-manager-cli.exe
```
## 发布到 GitHub
1. 在 GitHub 创建一个空仓库，例如 `mcp-manager`。
2. 本地初始化并推送：
```powershell
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：
```powershell
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
MCP 市场