Cleric

Cleric

Cleric は、Claude desktop 用の Model Context Protocol（MCP）サーバーを管理するデスクトップアプリです。MCP サーバーの追加、削除、設定を簡単に行えるインターフェースを提供します。

MacOS および Windows 用のビルドは、次の場所から入手できます：https://github.com/pcarion/cleric/releases

注記： バージョン 0.3.0 は Windows でも利用できますが、Windows ではテストされていません。フィードバックをお待ちしています。MCP Inspector の起動と停止に関連するコードを確認する必要があります。

動作の仕組み

Cleric は、次の 2 つの設定ファイルを管理します。

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 を起動するツールバーボタンを追加しました。
  • Welcome ページにバージョンチェッカーを追加しました。
  • ツールバーボタンにマウスカーソルを合わせたときにヘルプテキストを表示するようにしました。

• 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. リポジトリをフォークします。
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 ドキュメント
• Fyne デモのソースコード

謝辞

このプロジェクトは、私が Fyne ツールキットに触れるきっかけとなりました。優れた参考資料となった Alex Ballas の go2tv プロジェクトに、特に感謝します。よく整理されたコードベースは Fyne の機能を見事に示しており、このアプリケーションの開発にあたって貴重な知見を与えてくれました。