1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GitHub リポジトリをそのまま MCP サーバー化して wxO エージェントから検索する(GitMCP × SSE)

1
Last updated at Posted at 2026-04-21

IBM watsonx Orchestrate(wxO)のリモート MCP 接続を試しています。

Track A では Streamable HTTP を使いましたが、今回は SSE(Server-Sent Events) を使います。

接続先はちょっと変わったサービス「GitMCP」。GitHub リポジトリの URL を入れるだけで、そのリポジトリを MCP サーバーとして公開してくれます。自分のリポジトリを wxO エージェントで検索させる、というメタな構成です。

コードは wxo-mcp-lab/03_remote-mcp/track-b に置いています。


GitMCP とは

GitMCP は任意の GitHub リポジトリをリモート MCP サーバーとして公開するサービスです。

https://gitmcp.io/{owner}/{repo}

この URL に接続するだけで、対象リポジトリの README やドキュメントを MCP ツールで検索・取得できるようになります。

  • GitHub アカウント不要
  • GitMCP へのサインアップ不要
  • サーバー構築不要
  • 認証不要

公開リポジトリであればどんなリポジトリでも即座に MCP サーバー化できます。

今回は自分のリポジトリ matsuo-iguazu/wxo-mcp-lab(この実験を含むリポジトリ)に接続します。wxO エージェントが wxo-mcp-lab の手順書を参照して回答する、というメタな構成です。


SSE とは

Track A で使った Streamable HTTP との違いを簡単に整理します。

Streamable HTTP SSE
通信方式 HTTP リクエスト/レスポンス サーバーからのイベントストリーム
wxO YAML transport: streamable_http transport: sse
用途 汎用(現在の主流) 古い MCP サーバーや一部サービス

YAML の transport: の値が変わるだけで、他の書き方は同じです。


YAML ファイル

Toolkit(toolkits/m-gitmcp.yaml)

spec_version: v1
kind: mcp
name: m-gitmcp
description: >
  GitMCP 経由で matsuo-iguazu/wxo-mcp-lab リポジトリのドキュメントを検索するリモート MCP ツールキット。
  SSE でパブリックサーバーに接続する。認証不要。
transport: sse
server_url: https://gitmcp.io/matsuo-iguazu/wxo-mcp-lab
tools:
  - "*"

Track A の Toolkit と比べると transport: sse と server_url: が変わっただけです。

Agent(agents/M-gitmcp-agent.yaml)

spec_version: v1
kind: native
name: M_gitmcp_agent
description: >
  GitMCP 経由で matsuo-iguazu/wxo-mcp-lab の README や手順書を自然言語で検索するエージェント。
  リモート MCP ツールキット m-gitmcp を通じて GitHub リポジトリのドキュメントを参照する。
instructions: |
  あなたは wxo-mcp-lab リポジトリ(https://github.com/matsuo-iguazu/wxo-mcp-lab)のナビゲーターです。
  ユーザーの質問に応じて、以下のツールを使ってリポジトリのドキュメントやコードを検索し、日本語で回答してください。

  ツールの使い方:
  - search_wxo_mcp_lab_documentation: ドキュメント(README など)をキーワード検索する
  - fetch_wxo_mcp_lab_documentation: ドキュメントの内容を取得する
  - search_wxo_mcp_lab_code: コードファイルをキーワード検索する
  - fetch_generic_url_content: 特定の URL のコンテンツを取得する

  回答ルール:
  1. 必ず日本語で回答すること
  2. 参照したファイル名(README.md など)を明示すること
  3. 手順や設定例はそのまま引用して見やすく提示すること
llm: groq/openai/gpt-oss-120b
style: react
tools:
  - m-gitmcp:search_wxo_mcp_lab_documentation
  - m-gitmcp:fetch_wxo_mcp_lab_documentation
  - m-gitmcp:search_wxo_mcp_lab_code
  - m-gitmcp:fetch_generic_url_content

ツール名の確認が必要

GitMCP が公開するツール名はリポジトリ名から自動生成されます。

matsuo-iguazu/wxo-mcp-lab に接続した場合、公開されるツールは以下の 4 本でした:

m-gitmcp:search_wxo_mcp_lab_documentation  ← ドキュメントのキーワード検索
m-gitmcp:fetch_wxo_mcp_lab_documentation   ← ドキュメントの内容取得
m-gitmcp:search_wxo_mcp_lab_code           ← コードのキーワード検索
m-gitmcp:fetch_generic_url_content         ← 任意 URL のコンテンツ取得

別のリポジトリに接続する場合はツール名が変わります(リポジトリ名の部分が変化)。

Toolkit をインポートした後に orchestrate tools list で確認し、エージェント YAML の tools: を更新してください。


手順

# 1. Toolkit をインポート
orchestrate toolkits import -f toolkits/m-gitmcp.yaml

# 2. インポートされたツール名を確認
orchestrate tools list | grep m-gitmcp

# 3. エージェント YAML の tools: とツール名が一致しているか確認
#    (異なる場合は agents/M-gitmcp-agent.yaml を編集)

# 4. エージェントをインポート
orchestrate agents import -f agents/M-gitmcp-agent.yaml

動作確認

wxO チャットで M_gitmcp_agent に話しかけると、リポジトリの README を参照して回答してくれます。

Q: このリポジトリにはどんな実験がありますか?
A: wxo-mcp-lab には以下の実験が含まれています。
   01_postgres-mcp: PostgreSQL への MCP 接続(Track A: 公式 npm パッケージ / Track B: FastMCP)
   02_google-services-mcp: Gmail 連携(OAuth refresh_token 方式)
   03_remote-mcp: リモート MCP サーバーへの接続(Streamable HTTP / SSE)
   …(README の内容を参照して回答)

Q: Track A の PostgreSQL 接続手順を教えて
A: 01_postgres-mcp/track-a/README.md を参照すると…
   (手順を引用して回答)

発展:IBM ADK リポジトリに接続する

自分のリポジトリは遊び心でつないでみましたが、もっと実用的な使い方があります。

IBM ADK リポジトリ(IBM/ibm-watsonx-orchestrate-adk)に接続すると、ADK のサンプルコードや設定ファイルを参照して回答するエージェントになります。

# toolkits/m-gitmcp.yaml の server_url を変更するだけ
server_url: https://gitmcp.io/IBM/ibm-watsonx-orchestrate-adk

公開ドキュメントだけでなく、GitHub 上のサンプルコードまで参照できる検索エージェントができます。


まとめ

  • GitMCP は GitHub リポジトリをそのままリモート MCP サーバー化するサービス
  • wxO Toolkit の transport: sse + server_url: https://gitmcp.io/... で接続できる
  • ツール名はリポジトリ名から自動生成されるため、インポート後に orchestrate tools list で確認が必要
  • 別のリポジトリに変えるときは server_url: を書き換えるだけ

Track A(Streamable HTTP)と合わせると、YAML の transport: を切り替えるだけで 2 種類のリモート接続に対応できることがわかります。


シリーズ


(本記事は、執筆にあたりAnthropic Claudeを利用し、その出力を参考にしています。)

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?