mcp-connector

MCP Connector

任意の MCP（Model Context Protocol）サーバーに接続し、そのツール、リソース、プロンプトを操作できます。

サポートされているトランスポート

• stdio — ローカルの MCP サーバーをサブプロセスとして起動します（例: npx @modelcontextprotocol/server-filesystem /path）
• sse — HTTP Server-Sent Events 経由でリモートの MCP サーバーに接続します
• streamable-http — より新しいストリーミング可能な HTTP トランスポート経由で接続します（SSE レスポンスを伴う POST）

使用の流れ

1. mcp_browse で利用可能なサーバーを閲覧します（カテゴリでフィルタリングも可能）
2. レジストリから名前を指定して接続します: mcp_connect(name="coingecko")
3. mcp_list_tools または mcp_list_resources で利用可能なツール／リソースを検出します
4. mcp_call_tool または mcp_read_resource でそれらを使用します
5. 完了したら mcp_disconnect で切断します

事前設定済みレジストリ

厳選された MCP サーバーのリストが config/mcp_servers.yaml で管理されています。URL やトランスポートの詳細を指定せずに、名前を指定するだけでそのいずれかに接続できます:

mcp_connect(name="coingecko")     # Crypto market data
mcp_connect(name="exa")           # Neural web search
mcp_connect(name="dexpaprika")    # DEX data across chains

mcp_browse() を使用すると、利用可能なすべてのサーバーを確認できます。カテゴリでフィルタリングすることもできます:

mcp_browse(category="blockchain")
mcp_browse(category="developer")

一部のサーバーには環境変数（API キー）が必要です。不足しているものはツールが通知します。

アドホック接続

トランスポートの詳細を指定することで、レジストリにない任意の MCP サーバーにも接続できます:

stdio（ローカルサブプロセス）

mcp_connect(
    name="fs",
    transport="stdio",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
)

SSE（HTTP Server-Sent Events）

mcp_connect(
    name="remote-tools",
    transport="sse",
    url="https://mcp.example.com/sse"
)

Streamable HTTP

mcp_connect(
    name="api-server",
    transport="streamable-http",
    url="https://mcp.example.com/mcp"
)

接続済みサーバーの使用

ツールの呼び出し

mcp_call_tool(
    server="coingecko",
    tool="get_price",
    arguments={"coin": "bitcoin"}
)

リソースの読み取り

mcp_read_resource(
    server="remote-tools",
    uri="file:///data/config.json"
)

注意事項

• 接続はセッションの間、維持されます
• 複数のサーバーに同時に接続できます
• サーバー名は一意である必要があります — 同じ名前で再接続すると、古い接続が置き換えられます
• 環境変数は env パラメーターを介して stdio サーバーに渡すことができます
• レジストリのエントリは config/mcp_servers.yaml にあります — 新しいサーバーはそこに追加してください（コードの変更は不要です）