Cleric

Cleric

Cleric 是一款桌面应用，可帮助你管理 Claude desktop 的模型上下文协议（MCP）服务。它提供了易于使用的界面，方便你添加、移除和配置 MCP 服务。

MacOS 和 Windows 版本可在此处获取：https://github.com/pcarion/cleric/releases

注意： 0.3.0 版本适用于 Windows，但尚未在 Windows 上测试。欢迎提供任何反馈。需要检查与启动和停止 MCP Inspector 相关的代码。

工作原理

Cleric 管理两个配置文件：

1. 个人服务列表，位于 $HOME/.cleric.json

   • 存储所有可用的 MCP 服务
   • 作为服务配置的备份

2. Claude Desktop 配置，位于 <OS specific path>/claude_desktop_config.json

   • 包含 Claude Desktop 当前使用的活动 MCP 服务

主要功能

• 在 Claude Desktop 中无缝切换 MCP 服务
• 修改配置时自动保留服务配置
• 与 Claude Desktop 同步：你手动添加到 Claude Desktop 的任何服务，都会在下次启动时自动添加到 Cleric 服务列表中
• 实时保存：更改会在你进行操作时自动保存
• 启动 MCP Inspector 来测试任意服务

使用方法

在应用左侧，你可以看到已配置的 MCP 服务列表。

带有勾选标记的服务表示当前已配置在 Claude Desktop 中。

应用右侧显示所选服务的信息：

Remove From Claude 按钮会从 Claude Desktop 中移除该服务，但该服务仍会保留在你的个人服务列表中。

✄ 按钮会同时从个人服务列表和当前配置在 Claude Desktop 中的服务列表中移除该服务。

🖊️ 按钮可用于编辑服务信息：

👁️ 按钮会显示在终端中启动 MCP Inspector 的命令：

重要提示

首次使用 Cleric 前，如果你曾在 Claude Desktop 中手动配置 MCP 服务，请先备份 claude_desktop_config.json 文件。

更改服务列表后，别忘了重启 Claude Desktop。

启动应用时遇到的 MacOS 问题

如果出现“无法打开，因为无法验证开发者”错误，可以使用以下方法解决。

• 按住 Control 键并点击应用图标，然后从快捷菜单中选择“打开”。
• 点击“打开”。

如果出现“cleric 已损坏，无法打开。你应该将它移到废纸篓。”错误，可以使用以下方法解决。

启动终端，然后运行以下命令：xattr -cr /path/to/cleric.app。

更新日志

• 0.5.0 - 2025-01-25

  • 移除启动 MCP Inspector 的功能。改为在对话框中显示启动 MCP Inspector 的命令，并提供复制按钮，将命令复制到剪贴板。

• 0.4.0 - 2025-01-17

  • 开始使用浅色主题

• 0.3.0 - 2025-01-16

  • 修复 Windows 上 MCP Inspector 的问题——尚未测试 Windows 版本。欢迎提供任何反馈。

• 0.2.0 - 2025-01-14

  • 所有工具栏按钮均可启动 MCP Inspector
  • 在欢迎页面添加版本检查器
  • 鼠标悬停在工具栏按钮上时显示帮助文本

• 0.1.0 - 2025-01-09

  • 首次发布

即将推出

• 添加一个按钮，用于在用户的默认文本编辑器中打开 Claude Desktop 配置文件。
• 添加一个按钮，用于在用户的默认文本编辑器中打开 Cleric 配置文件。

开发

前置条件

要构建和运行此项目，你需要：

• Go 1.23.4 或更高版本
• Fyne 工具包及其依赖项——更多信息请阅读 Fyne 入门指南

安装

• 克隆仓库：

git clone https://github.com/pcarion/cleric.git
cd cleric

2. 构建项目：

make build

构建后的二进制文件将位于 build 目录中。

运行应用程序

直接运行应用程序：

make run

项目结构

.
├── cmd/
│   └── cleric/          # Main application entry point
├── internal/
│   └── ui/             # UI components and logic
│   └── config/         # Code to manage the list of MCP servers
└── build/              # Build artifacts

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到该分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

本项目遵循根目录中 LICENSE 文件所载的条款。

版本

应用程序的版本信息在构建时从 cmd/cleric/version.txt 嵌入。

文档

• Fyne 文档
• Fyne 演示源代码

致谢

这个项目是我初次接触 Fyne 工具包的起点。特别感谢 Alex Ballas 的 go2tv 项目，它为我提供了出色的参考。其结构清晰的代码库充分展现了 Fyne 的能力，也为构建此应用程序提供了宝贵的见解。