MCP服务器管理工具

Cleric是一款桌面应用程序,帮助用户管理Claude桌面的Model Context Protocol (MCP)服务器,提供添加、删除和配置服务器的功能。

  • by pcarion
  • Go
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 pcarion/cleric

使用说明



牧师

Cleric是一个桌面应用程序,可帮助您管理模型上下文协议(MCP)服务器 克劳德桌面。它提供了一个易于使用的界面,用于添加、删除和配置MCP服务器。

MacOS和Windows版本可在以下网址获得:https://github.com/pcarion/cleric/releases

注: 版本 0.3.0 可用于Windows,但尚未在Windows上进行测试。欢迎任何反馈。应查看与启动和停止MCP检查器相关的代码。

运作原理

文员管理两个配置文件:

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

    • 存储所有可用的MCP服务器
    • 作为服务器配置的备份
  2. Claude桌面配置位于 <OS specific path>/claude_desktop_config.json

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

主要特点

  • 在Claude Desktop中无缝切换MCP服务器
  • 更改时自动保留服务器配置
  • 与Claude Desktop同步:您手动添加到Claude Desktop的任何服务器都将在下次启动时自动添加到您的文书服务器列表中
  • 实时保存:更改会在您进行更改时自动保存
  • 通过启动MCP检查器测试任何服务器

如何使用

在应用程序的左侧,您可以看到已配置的MCP服务器列表。

带有复选标记的服务器是当前在Claude桌面中配置的服务器。

应用程序的右侧显示有关所选服务器的信息:

这 Remove From Claude 按钮将从Claude桌面删除服务器,但服务器将保留在您的个人服务器列表中。

这 ✄ 按钮将从您的个人服务器列表和Claude桌面中当前配置的服务器列表中删除服务器。

这 🖊️ 按钮将允许您编辑服务器信息:

这 👁️ 按钮将显示在终端中启动MCP检查器的命令:

重要提示

首次使用Cleric之前,请备份您的 claude_desktop_config.json 如果您在Claude Desktop中手动配置了MCP服务器,请使用该文件。

更改服务器列表后,不要忘记重新启动Claude Desktop。

启动应用程序时出现MacOS问题

如果出现“无法打开,因为无法验证开发人员”错误,可以应用以下解决方法。

  • 控制单击应用程序图标,然后从快捷菜单中选择“打开”。
  • 单击“打开”。

如果你收到“牧师损坏,无法打开。你应该把它移到垃圾箱。”错误,你可以应用以下解决方法。

启动终端,然后发出以下命令: xattr -cr /path/to/cleric.app.

更新日志

  • 0.5.0 - 2025-01-25

    • 删除启动MCP检查器的功能。相反,在带有复制按钮的对话框中显示启动MCP检查器的命令,以将命令复制到剪贴板。
  • 0.4.0 - 2025-01-17

    • 开始使用灯光主题
  • 0.3.0 - 2025-01-16

    • 修复Windows上MCP检查器的问题-Windows版本尚未经过测试。欢迎任何反馈。
  • 0.2.0 - 2025-01-14

    • 所有工具栏按钮,用于启动MCP检查器
    • 在欢迎页面上添加版本检查器
    • 将鼠标悬停在工具栏按钮上时添加帮助文本
  • 0.1.0 - 2025-01-09

    • 初始版本

即将推出

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

发展

先决条件

要构建和运行此项目,您需要:

  • 转到1.23.4或更高版本
  • Fyne工具包及其依赖项-阅读 Fyne入门指南 文档以获取更多信息

安装

  • 克隆存储库:
git clone https://github.com/pcarion/cleric.git
cd cleric
  1. 构建项目:
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. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

本项目的许可条款见 LICENSE 根目录中的文件。

版本

应用程序版本信息在构建时从以下位置嵌入 cmd/cleric/version.txt.

文档

致谢

这个项目是我对Fyne工具包的介绍。特别感谢Alex Ballas go2tv 项目,这是一个很好的参考。他结构良好的代码库完美地展示了Fyne的能力,并为构建这个应用程序提供了宝贵的见解。