GitMCP

GitMCP

GitMCP とは • 機能 • はじめに • 仕組み • バッジ • 使用例 • FAQ • プライバシー • 貢献 • ライセンス

🤔 GitMCP とは？

雰囲気で幻覚を起こすのはやめて、雰囲気でコーディングを始めましょう！

GitMCP は、あらゆる GitHub プロジェクト（リポジトリまたは GitHub Pages）をドキュメントハブに変換する、無料のオープンソースのリモート Model Context Protocol（MCP） サーバーです。LLM がそれらを知らなくても、Cursor などの AI ツールが最新のドキュメントやコードにアクセスできるようにし、コードの幻覚をシームレスに解消します。

GitMCP には2 種類あります。

• 特定のリポジトリ（gitmcp.io/{owner}/{repo} または {owner}.gitmcp.io/{repo}）： 主に限られた数のライブラリを扱う場合に使用します。AI アシスタントが常に正しいプロジェクトを対象とするため、意図しないリポジトリへのアクセスを防ぎ、セキュリティと関連性を高めます。
• 汎用サーバー（gitmcp.io/docs）： 異なるリポジトリを頻繁に切り替える必要がある場合に、最大限の柔軟性を得るために使用します。AI アシスタントは、リクエストごとにアクセスするリポジトリを尋ねるか、コンテキストに基づいて判断します。その都度、対象のリポジトリを正しく識別できるかどうかに依存する点にご注意ください。

GitMCP を使用すると：

• AI アシスタントは、ソースから最新のドキュメントやコードに直接アクセスできます。
• 正確な API の使用方法と、信頼できるコード例が得られます。
• ニッチなライブラリ、新しいライブラリ、急速に変化するライブラリでも効果的に作業できます。
• 幻覚を大幅に減らし、コードの正確性を高められます。

たとえば、three.js のシーンを作成する際に、Cursor で同じワンショットプロンプトを使った結果を並べて比較したものです。

https://github.com/user-attachments/assets/fbf1b4a7-f9f0-4c0e-831c-4d64faae2c45

✨ 機能

• 😎 あらゆる GitHub プロジェクトの最新ドキュメント：AI アシスタントが GitHub プロジェクトのドキュメントやコードにシームレスにアクセスできるようにします。組み込みのスマート検索機能により、トークンを使いすぎることなく、AI が必要とする情報を正確に見つけられます！
• 🧠 幻覚をなくす：GitMCP を使うと、AI アシスタントは質問に対して正確で関連性の高い回答を提供できます。
• ☁️ セットアップ不要：GitMCP はクラウドで動作します。選択した GitMCP の URL を IDE に MCP サーバーとして追加するだけで使用できます。ダウンロード、インストール、登録、変更は不要です。
• 💬 チャット機能を内蔵：ブラウザー内のチャットでリポジトリのドキュメントと直接会話して、すぐに使い始められます！
• ✅ オープンで無料、プライベート：GitMCP はオープンソースで、完全無料で使用できます。個人情報やクエリを収集・保存しません。セルフホストも可能です！

🚀 はじめに

GitMCP は簡単に使えます！次の手順に従ってください。

ステップ 1：使用するサーバーの種類を選択する

接続先に応じて、次のいずれかの URL 形式を選択してください。

• GitHub リポジトリの場合：gitmcp.io/{owner}/{repo}
• GitHub Pages サイトの場合：{owner}.gitmcp.io/{repo}
• あらゆるリポジトリに対応する汎用ツール（動的）の場合：gitmcp.io/docs

{owner} を GitHub のユーザー名または組織名に、{repo} をリポジトリ名に置き換えてください。

便利な方法として、ランディングページの変換ツールを使って、GitHub URL を MCP URL に変換することもできます。

ステップ 2：AI アシスタントを接続する

以下の選択肢から AI アシスタントを選び、設定手順に従ってください。

Cursor の接続

~/.cursor/mcp.json にある Cursor の設定ファイルを更新してください。

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Claude Desktop の接続

1. Claude Desktop で、Settings > Developer > Edit Config に移動します
2. 設定を次の内容に置き換えます。

   {
     "mcpServers": {
       "gitmcp": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://gitmcp.io/{owner}/{repo}"
         ]
       }
     }
   }
   

Windsurf の接続

~/.codeium/windsurf/mcp_config.json にある Windsurf の設定ファイルを更新してください。

{
  "mcpServers": {
    "gitmcp": {
      "serverUrl": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

VSCode の接続

.vscode/mcp.json にある VSCode の設定ファイルを更新してください。

{
  "servers": {
    "gitmcp": {
      "type": "sse",
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Cline の接続

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json にある Cline の設定ファイルを更新してください。

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Highlight AI の接続

1. Highlight AI を開き、サイドバーにあるプラグインアイコン（@ マーク）をクリックします
2. サイドバー上部の Installed Plugins をクリックします
3. Custom Plugin を選択します
4. Add a plugin using a custom SSE URL をクリックします

プラグイン名：gitmcp SSE URL：https://gitmcp.io/{owner}/{repo}

HighlightAI にカスタム MCP サーバーを追加する詳しい方法は、ドキュメントを参照してください。

Augment Code の接続

1. Augment Code の設定を開きます
2. MCP セクションに移動します
3. 次の詳細情報を使って新しい MCP サーバーを追加します。

MCP サーバーの名前：git-mcp Docs

次のコマンドを使用します。

npx mcp-remote https://gitmcp.io/{owner}/{repo}

または、次の設定を使用します。

{
  "mcpServers": {
    "git-mcp Docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Msty AI の接続

1. Msty Studio を開きます
2. Tools > Import Tools from JSON Clipboard に移動します
3. 次の設定を貼り付けます。

{
  "mcpServers": {
    "git-mcp Docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Augment Code で MCP サーバーを設定する詳しい方法は、Augment Code のドキュメントをご覧ください。

注： {owner} と {repo} は、実際の GitHub のユーザー名／組織名とリポジトリ名に置き換えてください。動的エンドポイント https://gitmcp.io/docs を使用すると、AI が必要に応じてあらゆるリポジトリにアクセスできるようになります。

⚙ 仕組み

GitMCP は、外部ソースから追加情報を取得するよう AI ツールにリクエストできる標準規格である Model Context Protocol（MCP）を使用して、AI アシスタントを GitHub リポジトリに接続します。

GitMCP を使用すると、次のような処理が行われます。

1. GitMCP の URL を AI アシスタントに指定します（例：gitmcp.io/microsoft/typescript）。GitMCP は、ドキュメントの取得、スマート検索、コード検索などのツールを提供します。
2. ドキュメントやコードに関する質問を** AI アシスタントにプロンプトとして入力します**。
3. AI がリクエストを送信し、GitMCP のツールを使用します（承認が必要です）。
4. GitMCP が AI のリクエストを実行し、要求されたデータを返します。
5. AI が情報を受け取り、幻覚のない、より正確で根拠に基づいた回答を生成します。

対応ドキュメント

GitMCP は現在、次のドキュメントに対応しています（優先順位順）。

1. llms.txt
2. プロジェクトのドキュメントの AI 向け最適化版
3. README.md／ルート

💡 使用例

さまざまな AI アシスタントやリポジトリで GitMCP を使用する例を紹介します。

例 1：特定のリポジトリで Windsurf を使用する

GitHub リポジトリ https://github.com/microsoft/playwright-mcp の場合、Windsurf に MCP サーバーとして https://gitmcp.io/microsoft/playwright-mcp を追加します。

Claude へのプロンプト：

「Playwright MCP の使い方を教えてください」

Windsurf は GitMCP から関連ドキュメントを取得し、メモリ機能を正しく実装します。

例 2：GitHub Pages サイトで Cursor を使用する

GitHub Pages サイト langchain-ai.github.io/langgraph では、https://langchain-ai.gitmcp.io/langgraph を MCP サーバーとして Cursor に追加します。

Cursor へのプロンプト：

「LangGraph エージェントにメモリを追加してください」

Cursor は GitMCP から関連するドキュメントとコードを取得し、メモリ機能を正しく実装します。

例 3：動的エンドポイントで Claude Desktop を使用する

特定のリポジトリを選ぶ必要はありません。汎用の gitmcp.io/docs エンドポイントを使うと、AI がその場で GitHub プロジェクトを選択できます！

任意の AI アシスタントへのプロンプト：

「OpenAI Whisper 音声認識モデルについて知りたいです。どのように機能するのか説明してください。」

Claude は GitMCP からデータを取得し、質問に回答します。

🛠️ ツール

GitMCP は、GitHub リポジトリへのアクセス、理解、検索に役立つ複数の便利なツールを AI アシスタントに提供します。

fetch_<repo-name>_documentation

このツールは、GitHub リポジトリの主要なドキュメントを取得します。関連するドキュメント（例：llms.txt）を取得する仕組みです。これにより、AI はプロジェクトの概要を把握できます。

役立つ場面： プロジェクトの目的、機能、または始め方に関する一般的な質問

search_<repo-name>_documentation

このツールを使うと、特定の検索クエリを指定して、リポジトリのドキュメントを検索できます。すべてのドキュメント（非常に大きい場合があります）を読み込む代わりに、インテリジェントな検索で関連する箇所だけを見つけます。

役立つ場面： プロジェクト内の特定の機能、関数、概念に関する質問

fetch_url_content

このツールは、ドキュメント内に記載されたリンクから AI が情報を取得するのに役立ちます。リンク先のコンテンツを取得し、AI が読み取りやすい形式に変換します。

役立つ場面： 質問への回答に役立つ外部情報がドキュメントで参照されている場合

search_<repo-name>_code

このツールは GitHub のコード検索を使って、リポジトリ内の実際のコードを検索します。AI が具体的なコード例や実装の詳細を見つけるのに役立ちます。

役立つ場面： ある機能の実装例を知りたい場合や、ドキュメントに記載されていない技術的な詳細が必要な場合

注： 動的エンドポイント（gitmcp.io/docs）を使用する場合、これらのツールの名前は少し異なり（fetch_generic_documentation、search_generic_code、search_generic_documentation）、アクセスするリポジトリに関する追加情報が必要です。

📊 バッジ

GitMCP は、リポジトリの README に追加できるバッジを用意しています。ユーザーは IDE またはブラウザー（埋め込みチャットを使用）からドキュメントにすばやくアクセスできます。また、GitMCP 経由でドキュメントがアクセスされた回数も表示されます。

例（idosal/git-mcp）：

リポジトリにバッジを追加する

以下を README.md に追加します。

[![GitMCP](https://img.shields.io/endpoint?url=https://gitmcp.io/badge/OWNER/REPO)](https://gitmcp.io/OWNER/REPO)

OWNER を GitHub のユーザー名または組織名に、REPO をリポジトリ名に置き換えてください。

ビュー数のカウント方法

該当するリポジトリに対するツール呼び出しごとに加算されます。

バッジをカスタマイズする

パラメーターを指定して、バッジの外観をカスタマイズできます。

パラメーター	説明	デフォルト	例
color	バッジの値の色	aquamarine	?color=green
label	バッジのラベル	GitMCP	Documentation

サポートが必要な場合は、お気軽にお問い合わせください！

❓ FAQ

Model Context Protocol とは何ですか？

Model Context Protocol は、AI アシスタントが外部ソースから追加のコンテキストを構造化された方法で要求および受信できるようにする標準です。これにより、理解力とパフォーマンスが向上します。

GitMCP はどの AI アシスタントでも動作しますか？

はい。GitMCP は、Cursor、VSCode、Claude などのツールを含め、Model Context Protocol に対応したあらゆる AI アシスタントと互換性があります。

GitMCP はすべての GitHub プロジェクトと互換性がありますか？

もちろんです！GitMCP は、変更を加えることなく、あらゆる公開 GitHub リポジトリで動作します。llms.txt ファイルを優先し、そのファイルがない場合は README.md やその他のページを使用します。今後のアップデートでは、追加のドキュメント方式への対応や、コンテンツの動的な生成も目指しています。

GitMCP の利用に料金はかかりますか？

いいえ。GitMCP はコミュニティに無料で提供されており、費用は一切かかりません。

🔒 プライバシー

GitMCP は、ユーザーのプライバシー保護に深く取り組んでいます。認証を必要としないため、個人を特定できる情報にアクセスしたり、保存したりすることはありません。また、エージェントから送信されたクエリも保存しません。さらに、GitMCP はオープンソースプロジェクトであるため、ご自身の環境に独立してデプロイできます。

GitMCP は、すでに公開されているコンテンツに、ユーザーからクエリがあった場合にのみアクセスします。GitMCP がリポジトリを自動的にスクレイピングすることはありません。GitHub Pages サイトにアクセスする前に、コードは robots.txt のルールを確認し、サイト所有者が設定した指示に従います。これにより、サイト所有者はアクセスを拒否できます。GitMCP は、GitHub プロジェクトやそのコンテンツに関するデータを恒久的に保存しないことにご注意ください。

👥 コントリビュート

コントリビュート、フィードバック、アイデアを歓迎します！コントリビューションガイドラインをご確認ください。

ローカル開発環境のセットアップ

1. リポジトリをクローンする

   git clone https://github.com/idosal/git-mcp.git
   cd git-mcp
   

2. 依存関係をインストールする

   pnpm install
   

3. 開発用にローカルで実行する

   npm run dev
   # or
   pnpm dev
   

テストに MCP Inspector を使用する

1. MCP Inspector ツールをインストールします：

   npx @modelcontextprotocol/inspector
   

2. Inspector のインターフェースで：

   • Transport Type を SSE に設定します
   • GitMCP の URL（例：http://localhost:5173/docs）を入力します
   • 「Connect」をクリックします

📄 ライセンス

このプロジェクトは、Apache License 2.0 のもとでライセンスされています。

免責事項

GitMCP は、いかなる種類の保証もなく「現状のまま」提供されます。本サービスの信頼性とセキュリティの確保に努めていますが、その利用によって生じる損害や問題について、当方は責任を負いません。GitMCP を通じてアクセスする GitHub プロジェクトには、それぞれの所有者が定める利用規約が適用されます。GitMCP は GitHub や、ここで言及されている AI ツールとは提携していません。

スター履歴