MCP Agent Connector

MCP Agent Connector

はじめに

MCP Agent Connector は、Claude、Grok、TypingMind、Cursor などの MCP 準拠エージェントプラットフォームで、生成された MCP サーバーを自動検出し、ビルドメタデータから機能を直接同期できるようにする、強力なオープンソースライブラリです。このライブラリは、MCP サーバーの検出を自動化し、クライアント環境とのリアルタイム同期を確実にすることで、統合プロセスを効率化します。

機能

• MCP サーバーマニフェストの自動公開：MCP サーバーで利用可能なツールとリソースのマニフェストを自動的に公開します。
• mcp-agent と Lutra エージェントに対応：mcp-agent と Lutra の両方のエージェントプラットフォームと互換性があり、柔軟な統合オプションを提供します。
• ローカルネットワーク経由のメタデータブロードキャスト（任意）：任意でローカルネットワーク経由でメタデータをブロードキャストし、対応するエージェントによる自動検出を容易にします。
• Claude Desktop の設定による Claude エージェントのマッピング：Claude Desktop の設定を使用して Claude エージェントをマッピングし、シームレスに統合します。
• クライアント環境とのリアルタイム同期：クライアント環境を常に最新の状態に保ち、MCP サーバーの最新の機能と情報を反映します。

インストール手順

mcp_agent_connector ライブラリをインストールするには、pip を使用します。

pip install mcp-agent-connector

または、リポジトリをクローンして手動でインストールする場合は、次の手順に従ってください。

1. リポジトリをクローンします。

   git clone https://github.com/your-username/mcp_agent_connector.git
   

2. プロジェクトディレクトリに移動します。

   cd mcp_agent_connector
   

3. pip を使用してライブラリをインストールします。

   pip install .
   

使用例

例 1：基本的な初期化と自動公開

from mcp_agent_connector import MCPAgentConnector

# Initialize the connector with default settings
connector = MCPAgentConnector()

# Start auto-publishing the MCP server manifest
connector.start()

例 2：Claude エージェントのマッピングに関するカスタム設定

from mcp_agent_connector import MCPAgentConnector, ClaudeConfig

# Define custom configuration for Claude agents
claude_config = ClaudeConfig(
    desktop_path="/path/to/claude/desktop/config",
    agent_mapping={"agent1": "server1", "agent2": "server2"}
)

# Initialize the connector with the custom configuration
connector = MCPAgentConnector(claude_config=claude_config)

# Start auto-publishing and mapping Claude agents
connector.start()

例 3：ローカルネットワーク経由のメタデータブロードキャストを有効にする

from mcp_agent_connector import MCPAgentConnector, BroadcastConfig

# Define broadcast configuration
broadcast_config = BroadcastConfig(
    enabled=True,
    network_interface="eth0",
    broadcast_interval=60  # seconds
)

# Initialize the connector with broadcast configuration
connector = MCPAgentConnector(broadcast_config=broadcast_config)

# Start broadcasting and auto-publishing
connector.start()

API ドキュメント

クラス：MCPAgentConnector

• __init__(self, claude_config=None, broadcast_config=None)

  • MCP Agent Connector を初期化します。
  • パラメーター：
    • claude_config：ClaudeConfig のインスタンス（任意）。Claude エージェントのマッピングに使用します。
    • broadcast_config：BroadcastConfig のインスタンス（任意）。ローカルネットワーク経由のメタデータブロードキャストを有効にします。

• start(self)

  • 自動公開プロセスと、Claude エージェントのマッピングやメタデータのブロードキャストなど、設定された追加機能を開始します。

クラス：ClaudeConfig

• __init__(self, desktop_path=None, agent_mapping=None)
  • Claude エージェントの設定を初期化します。
  • パラメーター：
    • desktop_path：Claude Desktop の設定ファイルへのパス（任意）。
    • agent_mapping：Claude エージェント名を MCP サーバー名に対応付ける辞書（任意）。

クラス：BroadcastConfig

• __init__(self, enabled=False, network_interface=None, broadcast_interval=30)
  • ローカルネットワークでのメタデータブロードキャスト設定を初期化します。
  • パラメーター：
    • enabled：（デフォルト：False）ブロードキャストが有効かどうかを示すブール値です。
    • network_interface：ブロードキャストに使用するネットワークインターフェース（任意）。
    • broadcast_interval：（デフォルト：30 秒）ブロードキャスト間隔です。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルをご覧ください。

---

プルリクエストの送信や GitHub での問題の報告により、このオープンソースライブラリにぜひご貢献ください。mcp_agent_connector の改善につながるフィードバックや提案を歓迎します。

⚠️ 開発状況

このライブラリは現在、開発の初期段階にあります。次の問題により、一部のテストが失敗する場合があります。

これらの問題を修正するためのご貢献を歓迎します。解決策をお持ちの場合は、プルリクエストをお送りください。