0
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 サーバをちょっとだけ叩いてみた

0
Posted at

最近、様々なサービスが MCP (Model Context Protocol) サーバを提供しているようである。
これは、サービスの操作を行う API をその説明とともに提供することで、サービスを AI から使いやすくすることを狙ったものである。

What is the Model Context Protocol (MCP)? - Model Context Protocol

今回は、そんな MCP サーバをちょっとだけ叩いてみた。
IT エンジニアの多くが使っていそうな GitHub を題材とすることにした。

GitHub の MCP サーバを用いる準備

エンドポイントの確認

GitHub - github/github-mcp-server: GitHub's official MCP Server · GitHub

を参照すると、GitHub の MCP サーバはエンドポイント

https://api.githubcopilot.com/mcp/

でアクセスできることがわかる。

アクセストークンの生成

GitHub の MCP サーバへアクセスするには、アクセストークンが必要である。
頑張れば OAuth を用いてアクセス権を得ることもできるようだが、今回は頑張らずに GitHub 上でアクセストークン (平文の文字列) を発行し、それを用いてアクセスする。

GitHub にログインし、右上のユーザーアイコンから「Settings」を開く。
左側のメニューの「Integrations」にある「Applications」を開く。
すると、以下のような画面になるので、「My GitHub Apps」を押す。

Applications 画面

遷移先の画面で、「Personal access tokens」内の「Fine-grained tokens」を押す。
(「Personal access tokens」はデフォルトで折りたたまれているので、まずこれを押して開く)

Fine-grained tokens の位置

以下のような画面になるので、「Generate new token」を押す。

Fine-grained personal access tokens 画面

以下のような画面になるので、「Token name」を適当に設定して「Generate token」を押す。
(今回は公開情報の取得のみを試すので、権限の設定はデフォルトで良い)

New fine-grained personal access token 画面

以下のような確認画面が出るので、「Generate token」を押す。

アクセストークン生成の確認画面

アクセストークンが生成された。
このアクセストークンを MCP サーバにリクエストを送る際に用いるので、保存しておく。

生成されたアクセストークンの表示

以上の操作手順および画面は執筆時点でのものであり、将来変更される可能性がある。

MCP サーバとの通信

MCP サーバとは、HTTP (S) プロトコルを用いて通信する。

Streamable HTTP - Model Context Protocol
Overview - Model Context Protocol

WebSocket や node などのコマンドを用いるタイプの MCP サーバもあるようだが、今回は扱わない。

リクエスト

リクエストには、以下の HTTP ヘッダを含める。

  • Accept: application/json,text/event-stream (これらの形式でのレスポンスを受け入れる)
  • Authorization: ~ (サーバが認証を要求する場合)
  • Mcp-***: ~ (ボディで送信する情報の一部をヘッダにも置く)
    • MCP-Protocol-Version:用いるプロトコルのバージョン
    • Mcp-Method:用いるメソッドの名前
    • Mcp-Name:行う操作の名前 (あれば)
    • Mcp-Param-***:操作時に渡す情報 (要求されたもの)

リクエストは POST メソッドを用い、ボディとして (今回は) 以下の形式の JSON を送信する。

{
  "jsonrpc": "2.0",
  "id": "<リクエストのID>",
  "method": "<用いるメソッドの名前>",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    },
    /* 操作に応じて要求されるデータ */
  }
}

「リクエストのID」は、文字列または数値を指定し、送信者が送信してまだ結果を受け取っていない他のリクエストと被らないようにする。
「メソッド」については後述する。

io.modelcontextprotocol/protocolVersion では、用いるプロトコルのバージョンを指定する。
今回は、執筆時点で最新のものを用いる。

レスポンス

リクエストを受け取った MCP サーバは、レスポンスとして JSON (Content-Type: application/json) または JSON が格納されたサーバー送信イベント (Content-Type: text/event-stream) を返す。

サーバー送信イベントは、以下の行を含みうるテキストデータである。

  • 空行:メッセージの区切り
  • : から始まる行:コメント (無視、接続の維持に用いられる)
  • event: から始まる行:イベントの種類
  • data: から始まる行:データ (ここでは JSON)

1個のメッセージ内に data: から始まる行が複数ある場合は、それらを1個の改行文字を挟んで結合したものをデータとみなす。

これ以外にも定義された行の種類があるが、ここでは扱わない。

curl による通信

今回は、curl を用いてリクエストを送り、レスポンスを受け取ってみる。
そのために、以下のオプションを用いる。

  • -H:リクエストとして送るヘッダを指定する
  • -d:リクエストとして送るボディを指定する

いずれも、@ファイル名 を指定することで、そのファイルの内容を送信できる。

curl 備忘録 - Smile Engineering Blog

今回は、今回行う各リクエストに共通のヘッダを格納した header.txt を用意する。

header.txt
Authorization: Bearer <アクセストークン>
Accept: application/json,text/event-stream
Content-Type: application/json
MCP-Protocol-Version: 2026-07-28

さらに、リクエスト固有のヘッダはコマンドラインで、ボディはファイルで指定してリクエストを行う。

-d でボディを指定すると、HTTP メソッドはデフォルトで POST になるので、-x POST を明示的に指定しなくてもよい。

MCP リクエストの実行

いよいよ、curl を用いて実際に GitHub の MCP サーバに対してリクエストを送ってみる。

サーバの機能を確認する

Discovery - Model Context Protocol

server/discover メソッドを用いることで、サーバの情報を取得できる。

これは新しい (2026-07-28 バージョンで導入された) 機能なので、MCP サーバによっては対応していないことがある。
もっとも、同バージョンの仕様によればこのメソッドの実装は必須であり、古いバージョンにしか対応していない MCP サーバではバージョン 2026-07-28 を指定してのリクエスト自体が弾かれるが……

以下のリクエストを送った。

discover.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "server/discover",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
コマンド
curl https://api.githubcopilot.com/mcp/ -H @header.txt \
     -H "Mcp-Method: server/discover" -d @discover.json

以下の応答が得られた。
(応答はサーバー応答イベントとして返ってきたが、ここではデータ本体のみを示す。また、見やすさのために整形を行って掲載する。以下同様)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "github-mcp-server",
        "title": "GitHub MCP Server",
        "version": "github-mcp-server/remote-6ffb60c40f9d564369fbd6cdd9cd0edd79579eae",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAADK0lEQVRIibWVQWhcVRSGv3Pfy0zGdBIMRWk7iziMTpORptpqiNSNG1dNizaFFlxIoYuCC7NwJdiVlhYprtwpighCF9GtuhCRtuCoaWdqGF7HkE4aWm1CpklmJpl3j4vMS99M2k4G9N+8d8659/8u9553H/zPkscVM5lMf03do6iOKbJXIAGgUBJ0GpHvolKfzOfzCx0BEonRWDRemRD0PaC3zSKXED1fLfdcLJUuV9oC0ukXdluxkyq81Ma4VX9Y4x4p5rOzjwSkUvsSdMkVYE+H5oHmjM9IoTA1FyRM8JJIjMbokm83zUW/Vvi5raXwC8rnjWiPdXRyYGCgOyi7wUs0XpkAXmyEa/XV8qmZmZnqc0P7XrXKW2BuKDovgorqLoWMFb4p3rj2I4w7qcHCMSAOctDt7n0X+GiDT6NbrPsXDw50xftzKg7odvcmtXf4DsJTjXBpzbXPzF6/vmgAauoepblbnGTyQLvu2VQmk4kgxEKpvui6cwSCM1Ada5qheq5YzC5tF5DP59dQzjYlZcOzccgyGK65mC+2ax7IWPfLcGxhKARgV7i4vBy70ymgUMj+A9SDWGB3GOCEB/f0VJ/sFJBKjfQS6srAOwD8HR7su/7BTgE2Umn98u9uAgR+ayqpnOkUIK1zZMPTACjyQzOA11ND+z+E8aate4TMs4PD7wu80ezP940nJJMH+ky0XgKeAHkH1TcRXgNywFeoueJN//5T2CCZGT7kWBlV9CSwvwV6n/XuhOddLRuAYjG7hMjHgEH1tEb0BEgWeB44J8aebF2243Nc0fMPMUfgguddLUOoe/r7dlwWJzqGMCxq6q5Wz/jSVQZ+Nb795N69u4thk/6dT7uInNiyYcoU9ZW3FxYWfAjdpp7n1XzjHAbmUJ3wTXQ8gvOZb+oXV1d3zLf6WEcWW3MoJXX9w57n1YKUCdeL+eysOv4oyrQqn65Tv+1adz4WrxzaskXWNs0V5Jq6/is3c7lb4byhRTdzuVvUV0ZQPgDuA6jqlj+fqhvkllE9q+vLL7eab4Afo1RqpJdI9Rhr3ZeCQwuUTqfjvoket7WuS51cjP+5/gWC8y5uIkrtDQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAAB8ElEQVRIibWVu09UQRSHv9k1IgW7AY0RBWKsTGx9ND4qS5F/wEYLDb0xAY0UxkdrZ2NHYWfsaYyVT4iJwZpNjJooLBQEYz6LvZsdxmH3LtFfN3PO+X5zzzwu/GeFbkF1BJgCJoHjwFgRagDLwAvgeQjhR1+u6qA6q67ZW6vqjDpYFn5YfV0CnOqDOtELPqY2dgFvq6Ee6daWd1HyvPqyBPSV+jQav1H3tbkhMpgF7hXDLaAeQthUzwFXgE/AF0BgFDgBPAshLKhV4CcwVNTPhBAexKsfcfuGbqhdT1imA1+j+lV1GKBSxKeAWpRfTca94HuB+BTVgcuxwWRS8zCEsFbWIISwBcwl0x2m+jnZuKNl4RHjQMJYjoPNJFju0vxt8itiNKHTomqSO7wLeA3YE01VYoPvSf7Jfg2AU8n4W2zwPglO78Igrekw1enMDb1fXKCuUivq7Uz99Tiprq6rvwuzhSLpo3pLvZABn1Vv2nrkUjWLPdlWMFcEF9WD6tuo4EnG4HEG3Nad3KcOqEtRe/bb+ic8Uo9l8i/tAF9UB3bq54StJ3dTvaGOqofM3IuiRalW1PH8bnUKx4tVxLqYyTuf5Czl4JV0IoSwApwB7gLr7enMWtpzG7TeodNFbXmpNfWq6YloxYbUa2q9L+i/1h8/EAGdUrF9ZQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      }
    },
    "ttlMs": 0,
    "cacheScope": "public",
    "supportedVersions": [
      "2026-07-28",
      "2025-11-25",
      "2025-06-18",
      "2025-03-26",
      "2024-11-05"
    ],
    "capabilities": {
      "completions": {},
      "prompts": {},
      "resources": {},
      "tools": {}
    },
    "instructions": "The GitHub MCP Server provides tools to interact with GitHub platform.\n\nTool selection guidance:\n\t1. Use 'list_*' tools for broad, simple retrieval and pagination of all items of a type (e.g., all issues, all PRs, all branches) with basic filtering.\n\t2. Use 'search_*' tools for targeted queries with specific criteria, keywords, or complex filters (e.g., issues with certain text, PRs by author, code containing functions).\n\nContext management:\n\t1. Use pagination whenever possible with batches of 5-10 items.\n\t2. Use minimal_output parameter set to true if the full information is not needed to accomplish a task.\n\nTool usage guidance:\n\t1. For 'search_*' tools: Use separate 'sort' and 'order' parameters if available for sorting results - do not include 'sort:' syntax in query strings. Query strings should contain only search criteria (e.g., 'org:google language:python'), not sorting instructions. Always call 'get_me' first to understand current user permissions and context. ## Issues\n\nCheck 'list_issue_types' first for organizations to use proper issue types. Use 'search_issues' before creating new issues to avoid duplicates. Always set 'state_reason' when closing issues. ## Pull Requests\n\nPR review workflow: Always use 'pull_request_review_write' with method 'create' to create a pending review, then 'add_comment_to_pending_review' to add comments, and finally 'pull_request_review_write' with method 'submit_pending' to submit the review for complex reviews with line-specific comments.\n\nBefore creating a pull request, search for pull request templates in the repository. Template files are called pull_request_template.md or they're located in '.github/PULL_REQUEST_TEMPLATE' directory. Use the template content to structure the PR description and then call create_pull_request tool."
  }
}

result メンバに DiscoverResult のデータが格納されている。これは以下を含む。

  • capabilities:サーバが対応している機能を表す。たとえば、tools メンバがあればツールの呼び出しに対応している
  • supportedVersions:サーバが対応している MCP のバージョンのリストを表す
  • instructions:サーバやその機能についての自然言語での説明。無い可能性もある

サーバで使えるツールのリストを取得する

tools/list メソッドを用いることで、サーバで使えるツールのリストを取得できる。

以下のリクエストを送った。

toollist.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
コマンド
curl https://api.githubcopilot.com/mcp/ -H @header.txt \
     -H "Mcp-Method: tools/list" -d @toollist.json

以下の応答が得られた。
(整形に加え、かなり長いので一部を省略して掲載する)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "github-mcp-server",
        "title": "GitHub MCP Server",
        "version": "github-mcp-server/remote-6ffb60c40f9d564369fbd6cdd9cd0edd79579eae",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAADK0lEQVRIibWVQWhcVRSGv3Pfy0zGdBIMRWk7iziMTpORptpqiNSNG1dNizaFFlxIoYuCC7NwJdiVlhYprtwpighCF9GtuhCRtuCoaWdqGF7HkE4aWm1CpklmJpl3j4vMS99M2k4G9N+8d8659/8u9553H/zPkscVM5lMf03do6iOKbJXIAGgUBJ0GpHvolKfzOfzCx0BEonRWDRemRD0PaC3zSKXED1fLfdcLJUuV9oC0ukXdluxkyq81Ma4VX9Y4x4p5rOzjwSkUvsSdMkVYE+H5oHmjM9IoTA1FyRM8JJIjMbokm83zUW/Vvi5raXwC8rnjWiPdXRyYGCgOyi7wUs0XpkAXmyEa/XV8qmZmZnqc0P7XrXKW2BuKDovgorqLoWMFb4p3rj2I4w7qcHCMSAOctDt7n0X+GiDT6NbrPsXDw50xftzKg7odvcmtXf4DsJTjXBpzbXPzF6/vmgAauoepblbnGTyQLvu2VQmk4kgxEKpvui6cwSCM1Ada5qheq5YzC5tF5DP59dQzjYlZcOzccgyGK65mC+2ax7IWPfLcGxhKARgV7i4vBy70ymgUMj+A9SDWGB3GOCEB/f0VJ/sFJBKjfQS6srAOwD8HR7su/7BTgE2Umn98u9uAgR+ayqpnOkUIK1zZMPTACjyQzOA11ND+z+E8aate4TMs4PD7wu80ezP940nJJMH+ky0XgKeAHkH1TcRXgNywFeoueJN//5T2CCZGT7kWBlV9CSwvwV6n/XuhOddLRuAYjG7hMjHgEH1tEb0BEgWeB44J8aebF2243Nc0fMPMUfgguddLUOoe/r7dlwWJzqGMCxq6q5Wz/jSVQZ+Nb795N69u4thk/6dT7uInNiyYcoU9ZW3FxYWfAjdpp7n1XzjHAbmUJ3wTXQ8gvOZb+oXV1d3zLf6WEcWW3MoJXX9w57n1YKUCdeL+eysOv4oyrQqn65Tv+1adz4WrxzaskXWNs0V5Jq6/is3c7lb4byhRTdzuVvUV0ZQPgDuA6jqlj+fqhvkllE9q+vLL7eab4Afo1RqpJdI9Rhr3ZeCQwuUTqfjvoket7WuS51cjP+5/gWC8y5uIkrtDQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAAB8ElEQVRIibWVu09UQRSHv9k1IgW7AY0RBWKsTGx9ND4qS5F/wEYLDb0xAY0UxkdrZ2NHYWfsaYyVT4iJwZpNjJooLBQEYz6LvZsdxmH3LtFfN3PO+X5zzzwu/GeFbkF1BJgCJoHjwFgRagDLwAvgeQjhR1+u6qA6q67ZW6vqjDpYFn5YfV0CnOqDOtELPqY2dgFvq6Ee6daWd1HyvPqyBPSV+jQav1H3tbkhMpgF7hXDLaAeQthUzwFXgE/AF0BgFDgBPAshLKhV4CcwVNTPhBAexKsfcfuGbqhdT1imA1+j+lV1GKBSxKeAWpRfTca94HuB+BTVgcuxwWRS8zCEsFbWIISwBcwl0x2m+jnZuKNl4RHjQMJYjoPNJFju0vxt8itiNKHTomqSO7wLeA3YE01VYoPvSf7Jfg2AU8n4W2zwPglO78Igrekw1enMDb1fXKCuUivq7Uz99Tiprq6rvwuzhSLpo3pLvZABn1Vv2nrkUjWLPdlWMFcEF9WD6tuo4EnG4HEG3Nad3KcOqEtRe/bb+ic8Uo9l8i/tAF9UB3bq54StJ3dTvaGOqofM3IuiRalW1PH8bnUKx4tVxLqYyTuf5Czl4JV0IoSwApwB7gLr7enMWtpzG7TeodNFbXmpNfWq6YloxYbUa2q9L+i/1h8/EAGdUrF9ZQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      }
    },
    "ttlMs": 0,
    "cacheScope": "public",
    "tools": [
      {
        "annotations": {
          "idempotentHint": false,
          "readOnlyHint": false,
          "title": "Add review comment to the requester's latest pending pull request review"
        },
        "description": "Add review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).",
        "inputSchema": {
          /* 中略 */
        },
        "name": "add_comment_to_pending_review",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAACwUlEQVRIie2Vz28UZRjHP993pi0QIC3YahNjirtmd3bS3Q1eUHvQEPUiEv8A4kXjwRJ78MCFBLjBBRKCHowHE38cNCbGGx6IUoKiodtNpoNmTJp4oSJNQ3pw29l5POxus2wo3QTwxPc0887zfD7zvu9kXnjEUfdNrjj5vJOmMP4e9JrfR1G02tuQD8tvgpck0dxCPwK30ViqnJTcr4bOmfRlI/PrhUJ5313woDpDpu8ss7f6nYHrvDnGcYlPsoY/bKaXwHY3HWfvgmNnMX0zvMM7069A3c3pkEYWa7UVgFxQPSfs7SSeH3k2rEy5jMubMBoG1yQ+SBbm53of+gCybMkk/H8VAFdbZisZLAFsJ11oyL+BUURcwrjWAZixXeIwxs/5UuVAr0QAYRjubGR+HWy3mb6QCIBXQe8nce0jgIkwfMo3/xLG085x8I9ofkMyUa0O+w2rgS0mcf3lboEDiKJo1cvsIDDr4D1DhTb8407hYhTdTJW+AvrdMnuhG9Je1m9BBzbfjXbyQcXypeqJLQt7+0rVE/mgYr3j7l7FDzOPBY8FDx6vc1EolPeNjI5/Jpgw7Lm9o+Pry//c/K0PhnLFyrSMDxE79jwxvn9079gvt28vrUD7V1EoFHalbltd2C7DfS4sAF4DTSdx7cL96LliZVriPPADuL+geRh0Z8il5SiKVn2ATENvCCYw78U/b8xdBcgHlYuGHQXuK5A4ClxM4vnXW8Lqp5JdWWt6h4CvWnsgxgDSbRZ3Gg0tCJ7sY4nGwDZOt/WBZtzN9FswLgM2sGann5mcPDaw5pWEHQH7cUu86SdkR3LF6tfrA814MNVpwNrM1leUxPXrSKfMeHcwdctyNotY8c3NbMX3LJsB3ZHsymDqlkHvYHYyievXWxPpSj4o75eYIuPWZof+vRKG4c61pncIx6gZsx34/5L/ACy3ElqUYhuvAAAAAElFTkSuQmCC",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAABn0lEQVRIie2Vvy5EURDGvyMUkhUU/pS2Q2clwvIKqL0Cm9ArrBcQShJPoLFR2YaIhIjQ7a7E39IiCgqVn8KsPY697E3oTHPumTPf990z986M9Mfm/A0wKGlMUlnSlnPuOQQAE5LOnXOFWErAIvBK1S6BZBAzZ2fzcckHjXwVaAXSwD2wWYN8A2iKK1ABt3m+ZeDRnseIthdgDxioxd1o662tfZIO7Lnf8xcklST1StqRdORxNEualHQIDDvnTmvdIGE5vwdWgLy93bQX0w0UgSdgKMC3AdfA7ndpSgKbduUbYBoI/7Ju4BiYrYFfAl4iBbxAgOyPgV9xWYDQ3xCXKK79C/wL/KJZoeW8QpsJCy0C54AMULaGmQu7sIAW4MpaxTKwbQU3U4dAxmLzwLpxXAIJP2jKgkY8Xx4o1SFwBmx7+7RxTUnVb9Bpa9HDFiR1/SRgWH+6FT3/h2qK6sBpB0aBB7yB880NcpaWtGHXjCsVBmb5PDIvgJ46BJKW84q9AguV87Adp/Q+9O8UMfQjRBKSxiV1SNp3zp3Ug/sVewPruexhKwhGXQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      },
      /* 中略 */
      {
        "annotations": {
          "idempotentHint": false,
          "readOnlyHint": true,
          "title": "Get tag details"
        },
        "description": "Get details about a specific git tag in a GitHub repository",
        "inputSchema": {
          "type": "object",
          "properties": {
            "owner": {
              "type": "string",
              "description": "Repository owner",
              "x-mcp-header": "owner"
            },
            "repo": {
              "type": "string",
              "description": "Repository name",
              "x-mcp-header": "repo"
            },
            "tag": {
              "type": "string",
              "description": "Tag name"
            }
          },
          "required": [
            "owner",
            "repo",
            "tag"
          ]
        },
        "name": "get_tag",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAABTklEQVRIie2UPUvDUBSGn5PW2qnYwUXExWhNpY2CUKT+BB10E3R0dnbrppuKLgouHbr5X5qlKRIFB+cuguBHj4O05KYfNsVJ+m7n3Hue54ZcrhDKQqGQTX1YVwg7QIbx0gh8b7VTJMMrqS+5RtgD7oDX2GhhC6UcbhkCVLZVuX1sesex4YCdX6uAGgIrsicjlrTGgQ9KVPDnmQgmgongPwgkXNiOq8ADMAtkx4UGvtflJvus20ANeIlN/vW5/kkt8L3D2HD6P9dRgSI8dQcc9w1IR3acBE3vbFSp8ZMVnoFSqJ/unZDe3pAYXyDIJarn9opbDZrewaAh2y7Oy5S1r6h5QG2Xxbw3piDw6xe244oKyxFmC5ihc+tS1qaqngKJyAEBGmZvSGzHVYT790T7aPozsaFoFZGboFGvDJsbOYuOuxuuc7n1uaV8sRSH8Q1DUVLnYLty3gAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAAA+ElEQVRIie2WLU5DQRRGzwUEirQCQ9BsoSGtZQHgSFgIsg4JXQCGP8V2QCBIEATZkJDgOJi+MJnMo30TFHmfmzvzfeeKyZ2BROpQvVHfrddDmhkZ4BY4Ai6BD7prAowjIoq7i85nFcGNf6qa1tayM1vAvBZQUg74c/WAHtAD/gMgn6YCT8A2MKwOTaZpCfAF3AGvFdlLx7XqdUVw4186rgWeE8Nn4cU67QLNAS/ASG3qmwVPqdaqjWw9A86BK+CkzaTuAseFBse/AiLiQg1gLzs3Bwb8XIp94AxYL/Af2xordap6v/htHKhv6nTlgBUAh9l6Rx11yfgG8ne/zwh2OysAAAAASUVORK5CYII=",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      },
      /* 中略 */
      {
        "annotations": {
          "idempotentHint": false,
          "readOnlyHint": false,
          "title": "Update pull request branch"
        },
        "description": "Update the branch of a pull request with the latest changes from the base branch.",
        "inputSchema": {
          /* 中略 */
        },
        "name": "update_pull_request_branch",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAACwUlEQVRIie2Vz28UZRjHP993pi0QIC3YahNjirtmd3bS3Q1eUHvQEPUiEv8A4kXjwRJ78MCFBLjBBRKCHowHE38cNCbGGx6IUoKiodtNpoNmTJp4oSJNQ3pw29l5POxus2wo3QTwxPc0887zfD7zvu9kXnjEUfdNrjj5vJOmMP4e9JrfR1G02tuQD8tvgpck0dxCPwK30ViqnJTcr4bOmfRlI/PrhUJ5313woDpDpu8ss7f6nYHrvDnGcYlPsoY/bKaXwHY3HWfvgmNnMX0zvMM7069A3c3pkEYWa7UVgFxQPSfs7SSeH3k2rEy5jMubMBoG1yQ+SBbm53of+gCybMkk/H8VAFdbZisZLAFsJ11oyL+BUURcwrjWAZixXeIwxs/5UuVAr0QAYRjubGR+HWy3mb6QCIBXQe8nce0jgIkwfMo3/xLG085x8I9ofkMyUa0O+w2rgS0mcf3lboEDiKJo1cvsIDDr4D1DhTb8407hYhTdTJW+AvrdMnuhG9Je1m9BBzbfjXbyQcXypeqJLQt7+0rVE/mgYr3j7l7FDzOPBY8FDx6vc1EolPeNjI5/Jpgw7Lm9o+Pry//c/K0PhnLFyrSMDxE79jwxvn9079gvt28vrUD7V1EoFHalbltd2C7DfS4sAF4DTSdx7cL96LliZVriPPADuL+geRh0Z8il5SiKVn2ATENvCCYw78U/b8xdBcgHlYuGHQXuK5A4ClxM4vnXW8Lqp5JdWWt6h4CvWnsgxgDSbRZ3Gg0tCJ7sY4nGwDZOt/WBZtzN9FswLgM2sGann5mcPDaw5pWEHQH7cUu86SdkR3LF6tfrA814MNVpwNrM1leUxPXrSKfMeHcwdctyNotY8c3NbMX3LJsB3ZHsymDqlkHvYHYyievXWxPpSj4o75eYIuPWZof+vRKG4c61pncIx6gZsx34/5L/ACy3ElqUYhuvAAAAAElFTkSuQmCC",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAABn0lEQVRIie2Vvy5EURDGvyMUkhUU/pS2Q2clwvIKqL0Cm9ArrBcQShJPoLFR2YaIhIjQ7a7E39IiCgqVn8KsPY697E3oTHPumTPf990z986M9Mfm/A0wKGlMUlnSlnPuOQQAE5LOnXOFWErAIvBK1S6BZBAzZ2fzcckHjXwVaAXSwD2wWYN8A2iKK1ABt3m+ZeDRnseIthdgDxioxd1o662tfZIO7Lnf8xcklST1StqRdORxNEualHQIDDvnTmvdIGE5vwdWgLy93bQX0w0UgSdgKMC3AdfA7ndpSgKbduUbYBoI/7Ju4BiYrYFfAl4iBbxAgOyPgV9xWYDQ3xCXKK79C/wL/KJZoeW8QpsJCy0C54AMULaGmQu7sIAW4MpaxTKwbQU3U4dAxmLzwLpxXAIJP2jKgkY8Xx4o1SFwBmx7+7RxTUnVb9Bpa9HDFiR1/SRgWH+6FT3/h2qK6sBpB0aBB7yB880NcpaWtGHXjCsVBmb5PDIvgJ46BJKW84q9AguV87Adp/Q+9O8UMfQjRBKSxiV1SNp3zp3Ug/sVewPruexhKwhGXQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      }
    ]
  }
}

result メンバ内の tools メンバに、サーバで使用できるツールの情報の配列が格納されている。
この配列の要素は、Tool である。

name メンバに、ツールを呼び出す際に使用するツールの名前が格納されている。
inputSchema メンバに、ツールを呼び出す際に要求される入力の情報が格納されている。
ここで x-mcp-header が指定されている項目については、サーバにリクエストを送る際、HTTP ヘッダにも同じ内容を指定しなければならない。

ツールを呼び出す

今回は、リストアップされたツールの中から、特定のリポジトリ内の特定のタグの情報を取得する get_tag ツールを呼び出してみる。

ツールを呼び出すには、tools/call メソッドを用いる。

以下のリクエストを送った。
今回は、stick_3020 リポジトリのタグ v1.1.0 の情報を取得してみた。
x-mcp-header が指定されていた owner と repo については HTTP ヘッダでも指定しているが、指定されていなかった tag については HTTP ヘッダとしては指定していない。

gettag.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_tag",
    "arguments": {
      "owner": "mikecat",
      "repo": "stick_3020",
      "tag": "v1.1.0"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
コマンド
curl https://api.githubcopilot.com/mcp/ -H @header.txt \
     -H "Mcp-Method: tools/call" -H "Mcp-Name: get_tag" \
     -H "Mcp-Param-owner: mikecat" -H "Mcp-Param-repo: stick_3020" -d @gettag.json

以下の結果が返ってきた。(データのみを整形して掲載)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "github-mcp-server",
        "title": "GitHub MCP Server",
        "version": "github-mcp-server/remote-3ec14fdb2e4c747a3b2846e8c8f0d92fe7bd39f0",
        "icons": [
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAADK0lEQVRIibWVQWhcVRSGv3Pfy0zGdBIMRWk7iziMTpORptpqiNSNG1dNizaFFlxIoYuCC7NwJdiVlhYprtwpighCF9GtuhCRtuCoaWdqGF7HkE4aWm1CpklmJpl3j4vMS99M2k4G9N+8d8659/8u9553H/zPkscVM5lMf03do6iOKbJXIAGgUBJ0GpHvolKfzOfzCx0BEonRWDRemRD0PaC3zSKXED1fLfdcLJUuV9oC0ukXdluxkyq81Ma4VX9Y4x4p5rOzjwSkUvsSdMkVYE+H5oHmjM9IoTA1FyRM8JJIjMbokm83zUW/Vvi5raXwC8rnjWiPdXRyYGCgOyi7wUs0XpkAXmyEa/XV8qmZmZnqc0P7XrXKW2BuKDovgorqLoWMFb4p3rj2I4w7qcHCMSAOctDt7n0X+GiDT6NbrPsXDw50xftzKg7odvcmtXf4DsJTjXBpzbXPzF6/vmgAauoepblbnGTyQLvu2VQmk4kgxEKpvui6cwSCM1Ada5qheq5YzC5tF5DP59dQzjYlZcOzccgyGK65mC+2ax7IWPfLcGxhKARgV7i4vBy70ymgUMj+A9SDWGB3GOCEB/f0VJ/sFJBKjfQS6srAOwD8HR7su/7BTgE2Umn98u9uAgR+ayqpnOkUIK1zZMPTACjyQzOA11ND+z+E8aate4TMs4PD7wu80ezP940nJJMH+ky0XgKeAHkH1TcRXgNywFeoueJN//5T2CCZGT7kWBlV9CSwvwV6n/XuhOddLRuAYjG7hMjHgEH1tEb0BEgWeB44J8aebF2243Nc0fMPMUfgguddLUOoe/r7dlwWJzqGMCxq6q5Wz/jSVQZ+Nb795N69u4thk/6dT7uInNiyYcoU9ZW3FxYWfAjdpp7n1XzjHAbmUJ3wTXQ8gvOZb+oXV1d3zLf6WEcWW3MoJXX9w57n1YKUCdeL+eysOv4oyrQqn65Tv+1adz4WrxzaskXWNs0V5Jq6/is3c7lb4byhRTdzuVvUV0ZQPgDuA6jqlj+fqhvkllE9q+vLL7eab4Afo1RqpJdI9Rhr3ZeCQwuUTqfjvoket7WuS51cjP+5/gWC8y5uIkrtDQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "light"
          },
          {
            "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABmJLR0QA/wD/AP+gvaeTAAAB8ElEQVRIibWVu09UQRSHv9k1IgW7AY0RBWKsTGx9ND4qS5F/wEYLDb0xAY0UxkdrZ2NHYWfsaYyVT4iJwZpNjJooLBQEYz6LvZsdxmH3LtFfN3PO+X5zzzwu/GeFbkF1BJgCJoHjwFgRagDLwAvgeQjhR1+u6qA6q67ZW6vqjDpYFn5YfV0CnOqDOtELPqY2dgFvq6Ee6daWd1HyvPqyBPSV+jQav1H3tbkhMpgF7hXDLaAeQthUzwFXgE/AF0BgFDgBPAshLKhV4CcwVNTPhBAexKsfcfuGbqhdT1imA1+j+lV1GKBSxKeAWpRfTca94HuB+BTVgcuxwWRS8zCEsFbWIISwBcwl0x2m+jnZuKNl4RHjQMJYjoPNJFju0vxt8itiNKHTomqSO7wLeA3YE01VYoPvSf7Jfg2AU8n4W2zwPglO78Igrekw1enMDb1fXKCuUivq7Uz99Tiprq6rvwuzhSLpo3pLvZABn1Vv2nrkUjWLPdlWMFcEF9WD6tuo4EnG4HEG3Nad3KcOqEtRe/bb+ic8Uo9l8i/tAF9UB3bq54StJ3dTvaGOqofM3IuiRalW1PH8bnUKx4tVxLqYyTuf5Czl4JV0IoSwApwB7gLr7enMWtpzG7TeodNFbXmpNfWq6YloxYbUa2q9L+i/1h8/EAGdUrF9ZQAAAABJRU5ErkJggg==",
            "mimeType": "image/png",
            "theme": "dark"
          }
        ]
      }
    },
    "content": [
      {
        "type": "text",
        "text": "{\"ref\":\"refs/tags/v1.1.0\",\"url\":\"https://api.github.com/repos/mikecat/stick_3020/git/refs/tags/v1.1.0\",\"object\":{\"type\":\"commit\",\"sha\":\"f6aa8ba45c07abfc32636a11a6dde7bcd831a693\",\"url\":\"https://api.github.com/repos/mikecat/stick_3020/git/commits/f6aa8ba45c07abfc32636a11a6dde7bcd831a693\"},\"node_id\":\"REF_kwDOMqlsnbByZWZzL3RhZ3MvdjEuMS4w\"}"
      }
    ],
    "resultType": "complete"
  }
}

result メンバ内の content メンバで渡される配列の要素として、結果の JSON がテキストデータとして得られた。
得られたデータを整形すると、以下のようになった。

{
  "ref": "refs/tags/v1.1.0",
  "url": "https://api.github.com/repos/mikecat/stick_3020/git/refs/tags/v1.1.0",
  "object": {
    "type": "commit",
    "sha": "f6aa8ba45c07abfc32636a11a6dde7bcd831a693",
    "url": "https://api.github.com/repos/mikecat/stick_3020/git/commits/f6aa8ba45c07abfc32636a11a6dde7bcd831a693"
  },
  "node_id": "REF_kwDOMqlsnbByZWZzL3RhZ3MvdjEuMS4w"
}

おわりに

今回は、アクセストークンを作成して GitHub の MCP サーバにアクセスし、ツールを呼び出してみることができた。

なお、MCP には、

  • 単純な文字だけでないデータを Mcp-Param-*** ヘッダで指定する方法
  • ツール以外のサーバの機能 (リソース・プロンプトなど)
  • JSON スキーマの検証
  • OAuth 2.1 による認証

など、今回扱っていない要素がたくさんある。
より深く知りたい場合は、仕様書を参照してほしい。

最後に、今回作成したアクセストークンは、今後使用する予定が無いのであれば削除しておくのがよいだろう。
また使いたくなったら、また新たにアクセストークンを作成すればよい。

0
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
0
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?