MCP Codex

🚀 MCP - Codex プロジェクトドキュメント

MCP - Codex は、モデルコンテキストプロトコル (Model Context Protocol, MCP) サーバーを調整するサービスです。このサービスは、AI アシスタントがサービスを再起動することなく、動的にツールを発見して使用できるようにすることを目的としています。その核心は「図書館員」と呼ばれるインテリジェントエージェントで、ユーザーのニーズを理解し、適切なツールと接続する役割を担っています。

🚀 クイックスタート

MCP - Codex を使用するには、以下の手順に従ってください。

Codex サービスの起動

python codex - serv.py

MCP クライアントの起動

python mcp - codex.py

Claude Desktop への統合

1. MCP クライアントのインストール：

   mcp install mcp - codex.py
   

2. 2 つのツールの登録：
   • search：関連するツールを検索します。
   • call_tool：発見したツールを実行します。

✨ 主な機能

解決する問題

従来の MCP 実装には、以下のような制限がありました。

1. 静的な設定：新しいツールを追加するには、AI サービスを再起動する必要があります。
2. ローカルでの実行：すべてのツールはローカルで実行する必要があります。
3. 限られた発見メカニズム：ツールの発見と選択のプロセスが柔軟性に欠けています。
4. 高い認知負荷：ユーザーは手動でツールを管理する必要があります。

提供する解決策

MCP - Codex は、これらの問題を解決するために以下のような機能を提供します。

1. 動的なツール発見：AI アシスタントは必要に応じて自動的に新しいツールを発見し、使用することができます。
2. 標準化されたインターフェース：ツールの発見と実行に統一されたインターフェースを提供します。
3. リモート実行のサポート：ツールは任意の場所で実行することができます。
4. 中央集権的な管理：ツールのデプロイと更新を管理するための単一の制御ポイントを提供します。

📦 インストール

使用方法の項を参照して、Codex サービス、MCP クライアントの起動、Claude Desktop への統合を行ってください。

📚 ドキュメント

プロジェクトのアーキテクチャ

核心コンポーネント

1. Codex サービス
   • ツールの検索と呼び出しのための REST API インターフェースを提供します。
   • ツールの登録、発見、実行を担当します。
2. 図書館員 (The Librarian)
   • 複雑なツール選択ロジックを担当するインテリジェントエージェントです。
   • 業界の知識ベースと内部ドキュメントデータベースを維持します。
3. ツールリポジトリ
   • すべての利用可能なツールとそのメタデータを保存します。
   • ツールのバージョン管理と互換性チェックをサポートします。

ツール登録の設定

ツールは config/codex.yaml ファイルで定義され、以下のような構造になっています。

tools:
  - name: tool_name
    description: ツールの説明
    server: path/to/tool/server.py
    methods:
      - method_name
    schemas:
      method_name:
        type: object
        properties:
          # パラメータの定義

API エンドポイント

• /health：ヘルスチェックエンドポイント
• /search：一致するツールを検索します。
• /call_tool：特定のツールメソッドを実行します。
• /reload：ツールの設定を再読み込みします。

プロジェクトのロードマップ

図書館員（詳細版）

• エージェント RAG システムとして：検索と生成のインテリジェンスを結合します。
• 複数の知識源の維持：
  • 業界の技術情報データベース
  • 内部ツールのドキュメントライブラリ
  • リアルタイムの MCP エコシステムインデックス
• 複雑なツール選択ロジックの実行：
  • ユーザーのクエリを分析して意図を識別します。
  • 必要な機能をマッチングします。
  • 全体の MCP エコシステムで最適なツールを検索します。
  • ツールの互換性、パフォーマンス、信頼性を考慮します。

プロジェクトの意義

1. 本当のエージェント機能の実現：AI アシスタントがユーザーのニーズに応じて動的にツールを発見し、使用できるようにします。
2. 運用の複雑さの軽減：サービスを再起動することなく新しい機能を追加できます。
3. 集中化されたツール管理：ツールのデプロイと更新を管理するための単一の制御ポイントを提供します。
4. 標準化されたツールインタラクション：ツールの発見と実行に一貫したインターフェースを作成します。
5. リモート実行のサポート：ツールは任意の場所で実行することができます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細なライセンス内容は LICENSE ファイルを参照してください。