STARWARCLOUD STARWAR.AI
返回市场
牧师

牧师

作者：pcarion3 星标更新：2025-01-25
安装使用来源：spider==github.com

项目介绍

<p align="center"> <img src="assets/cleric-logo.svg" width="100" alt="Cleric logo"> </p> <br/> <div align="center"> <p>

Go Report Card Release Version

</p> </div>

Cleric

Cleric 是一个桌面应用程序，帮助您管理用于 Claude 桌面版 的模型上下文协议（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 桌面版配置位于 <操作系统特定路径>/claude_desktop_config.json

    • 包含当前由 Claude 桌面版使用的活动 MCP 服务器

主要功能

  • 在 Claude 桌面版中无缝切换 MCP 服务器
  • 自动保存更改时的服务器配置
  • 同步 Claude 桌面版：手动添加到 Claude 桌面版的任何服务器将在下次启动时自动添加到您的 Cleric 服务器列表中
  • 实时保存：更改会自动保存
  • 通过启动 MCP Inspector 来测试任何服务器

如何使用

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

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

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

MCP 服务器信息

“从 Claude 中移除”按钮会将服务器从 Claude 桌面版中移除，但该服务器仍保留在您的个人服务器列表中。

“剪刀”按钮会将服务器从您的个人服务器列表以及当前配置在 Claude 桌面版中的服务器列表中移除。

“笔”按钮允许您编辑服务器信息：

MCP 服务器信息

“眼睛”按钮会显示在终端中启动 MCP Inspector 的命令：

MCP 服务器信息

重要提示

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

在对服务器列表进行了更改后，请记得重启 Claude 桌面版。

MacOS 启动应用的问题

如果遇到“无法打开，因为开发者无法验证”的错误，可以尝试以下解决方法。

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

如果遇到“cleric 已损坏且无法打开。您应该将其移到废纸篓。”的错误，可以尝试以下解决方法。

在终端中运行以下命令：xattr -cr /path/to/cleric.app。

更新日志

  • 0.5.0 - 2025-01-25

    • 移除了启动 MCP Inspector 的功能。取而代之的是，在对话框中显示启动 MCP Inspector 的命令，并提供复制按钮以将命令复制到剪贴板。

  • 0.4.0 - 2_25-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 桌面版配置文件。
  • 添加一个按钮，以在用户的默认文本编辑器中打开 Cleric 配置文件。

开发

前提条件

要构建并运行此项目，您需要：

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

安装

  • 克隆仓库：
git clone https://github.com/pcarion/cleric.git
cd cleric
  1. 构建项目：
make build

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

运行应用程序

要直接运行应用程序：

make run

项目结构

.
├── cmd/
│   └── cleric/          # 主应用程序入口点
├── internal/
│   └── ui/             # UI 组件和逻辑
│   └── config/         # 管理 MCP 服务器列表的代码
└── build/              # 构建工件

贡献

  1. 分叉仓库
  2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交您的更改 (git commit -m '添加一些惊人的功能')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

本项目根据根目录下的 LICENSE 文件中的条款进行许可。

版本

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

文档

致谢

这个项目是我对 Fyne 工具包的初次接触。特别感谢 Alex Ballas 的 go2tv 项目，它作为一个极好的参考。他结构良好的代码库展示了 Fyne 的能力，并为构建此应用程序提供了宝贵的见解。