内容
# 克劳德 MCP 配置文件管理器
克劳德桌面版 MCP（模型控制协议）配置文件管理工具。该工具允许您轻松切换克劳德桌面版的不同 MCP 配置。
## 功能特点
- 列出可用的 MCP 配置文件
- 在不同的 MCP 配置文件之间切换
- 将当前配置保存为新的配置文件
- 禁用 MCP 配置
- 检查当前 MCP 状态
- 自动创建配置文件目录
- 在更改配置文件或禁用 MCP 时自动重启克劳德应用
## 使用前提
- macOS（测试版本：macOS 14.0+）
- 已安装克劳德桌面版
- Zsh shell
## 安装步骤
1. 克隆此仓库：
```bash
git clone https://github.com/YUZongmin/claude-mcp-manager.git
cd claude-mcp-manager
```
2. 在项目根目录中创建 `.env` 文件，并填写您的配置：
```bash
# 克劳德桌面版配置路径
CLAUDE_CONFIG="/path/to/your/claude_desktop_config.json"
# 配置文件存储目录路径
PROFILES_DIR="/path/to/your/profiles/directory"
```
3. 使脚本可执行：
```bash
chmod +x mcp.sh
```
4. 将脚本添加到您的 `.zshrc` 文件中：
```bash
source "/path/to/claude-mcp-manager/mcp.sh"
```
5. 重新加载您的 shell 配置：
```bash
source ~/.zshrc
```
## 使用方法
该脚本提供了以下命令：
```bash
mcp ls # 列出所有可用的配置文件
mcp status # 显示当前 MCP 配置状态
mcp off # 禁用 MCP 配置并重启克劳德
mcp save 名称 # 将当前配置保存为新的配置文件
mcp 配置文件名称 # 切换到指定的配置文件并重启克劳德
```
### 示例用法
1. 首先，将当前的克劳德配置保存为配置文件：
```bash
mcp save default
```
2. 列出可用的配置文件：
```bash
mcp ls
```
3. 在配置文件之间切换（这将自动重启克劳德）：
```bash
mcp default
```
4. 检查当前状态：
```bash
mcp status
```
5. 禁用 MCP（这将自动重启克劳德）：
```bash
mcp off
```
### 自动应用重启
该脚本自动处理克劳德应用的生命周期：
- 在切换配置文件（`mcp 配置文件名称`）时，克劳德将重启以应用新的配置
- 在禁用 MCP（`mcp off`）时，克劳德将重启为默认配置
- 重启过程包括：
1. 如果克劳德正在运行，则正常关闭
2. 等待正确的关闭
3. 使用新配置重新打开克劳德
## 目录结构
```
claude-mcp-manager/
├── mcp.sh # 主脚本文件
├── .env # 配置文件（需要创建）
├── .gitignore # Git 忽略文件
├── README.md # 本文件
└── profiles/ # 存储配置文件的目录（自动创建）
```
## 配置
### 环境变量
在项目根目录中创建 `.env` 文件，并包含以下变量：
- `CLAUDE_CONFIG`: 克劳德桌面版配置文件路径
- 默认位置：`~/Library/Application Support/Claude/claude_desktop_config.json`
- `PROFILES_DIR`: 存储 MCP 配置文件的目录路径
- 如果目录不存在，该目录将自动创建
### 配置文件格式
配置文件存储为 `profiles/` 目录中的 JSON 文件。每个配置文件应遵循克劳德桌面版配置格式：
```json
{
"globalShortcut": "Control+Option+Space",
"mcpServers": {
// 您的 MCP 服务器配置信息
}
}
```
## 故障排除
1. 如果出现“command not found: mcp”：
- 确保您已在 `.zshrc` 文件中加载了脚本
- 运行 `source ~/.zshrc` 以重新加载您的 shell 配置
2. 如果出现“Error: .env file not found”：
- 确保您已在与 `mcp.sh` 相同的目录中创建了 `.env` 文件
- 检查您的 `.env` 文件中的路径是否正确
3. 如果配置文件未显示：
- 检查您的 `.env` 文件中的 `PROFILES_DIR` 路径是否正确
- 确保您至少使用 `mcp save 名称` 保存了一个配置文件
4. 如果克劳德未正确重启：
- 确保克劳德已安装在您的应用程序文件夹中
- 如有必要，请尝试增加脚本中的睡眠时间
- 检查您是否有足够的权限来控制该应用程序
## 贡献
1. 分叉仓库
2. 创建您的功能分支（`git checkout -b feature/amazing-feature`）
3. 提交您的更改（`git commit -m 'Add some amazing feature'`）
4. 推送到分支（`git push origin feature/amazing-feature`）
5. 打开拉取请求
## 许可证
该项目根据 MIT 许可证授权 - 有关详细信息，请参见 LICENSE 文件。
## 致谢
- 克劳德桌面版团队的 MCP 功能
- 开源社区的灵感和工具
MCP 市场