Github To MCP

🚀 GitHub to MCP

このツールは、任意のGitHubリポジトリを数秒でMCPサーバーに変換します。Claude、ChatGPT、Cursor、Windsurf、ClineなどのAIアシスタントに、即座に任意のコードベースにアクセスさせることができます。

🚀 クイックスタート

🌐 Web UI (最も簡単)

github-to-mcp.vercel.app にアクセスし、任意のGitHub URLを貼り付けて「Generate」をクリックし、MCPサーバーをダウンロードします。

💻 CLI (1コマンド)

npx @nirholas/github-to-mcp https://github.com/stripe/stripe-node

📦 プログラム的 (自動化用)

import { generateFromGithub } from '@nirholas/github-to-mcp';

const result = await generateFromGithub('https://github.com/stripe/stripe-node');
console.log(`Generated ${result.tools.length} tools`);
await result.save('./my-mcp-server');

✨ 主な機能

🔬 リポジトリ分析

• リポジトリの自動分類 (API、ライブラリ、CLIツール、MCPサーバー、ドキュメント)
• OpenAPI/Swagger仕様の検出と解析
• GraphQLスキーマの抽出とクエリ/ミューテーションツールの生成
• gRPC/Protobufサービス定義の解析
• イベント駆動型APIのAsyncAPI仕様のサポート
• 関数抽出のためのソースコード分析

🌍 多言語サポート

入力リポジトリ:

• TypeScriptとJavaScript
• Python
• Go
• JavaとKotlin
• Rust
• Ruby
• C#とF#

出力MCPサーバー:

• TypeScript (公式MCP SDKを使用)
• Python (MCP Python SDKを使用)
• Go (コミュニティMCPライブラリを使用)

🔧 ツール抽出

• OpenAPIエンドポイントを型付きパラメーターで呼び出し可能なツールに変換
• GraphQLクエリとミューテーションを入力検証付きのツールに変換
• @mcp.tool で装飾されたPython関数を保持
• READMEに記載されたCLIコマンドを実行可能なツールに変換
• 人気のあるフレームワークのHTTPルートハンドラーを検出

⚡ コード生成

• すべての依存関係を含む完全な実行可能なMCPサーバーコード
• Claude Desktop、Cursor、その他のクライアント用の設定ファイル
• Dockerデプロイメントテンプレート
• すべての生成されたツールのTypeScript型定義

📦 インストール

ソースからのインストール

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/nirholas/github-to-mcp.git
cd github-to-mcp
pnpm install
pnpm build

Webインターフェイスを使用する場合

Webアプリケーションは github-to-mcp.vercel.app にデプロイされています。ローカルにインストールすることなく、ブラウザベースのインターフェイスを使用できます。

💻 使用例

🌐 Webインターフェイス

Webインターフェイスは、リポジトリを変換する最も簡単な方法です。

1. Webアプリケーションにアクセスする
2. GitHubリポジトリのURLを入力する (例: https://github.com/owner/repo)
3. 必要に応じて抽出オプションを設定する
4. 「Generate」をクリックしてリポジトリを分析する
5. 生成されたツールとコードを確認する
6. MCPサーバーパッケージをダウンロードするか、設定をコピーする

Webインターフェイスには、ダウンロード前に生成されたツールをテストできるインタラクティブなプレイグラウンドもあります。

💻 コマンドラインインターフェイス

プロジェクトをローカルでビルドした後、CLIを使用できます。

# 基本的な使用法
node packages/core/dist/cli.mjs https://github.com/owner/repo

# 出力ディレクトリを指定する
node packages/core/dist/cli.mjs https://github.com/owner/repo --output ./my-mcp-server

# TypeScriptではなくPythonを生成する
node packages/core/dist/cli.mjs https://github.com/owner/repo --language python

# 特定の抽出ソースのみを含める
node packages/core/dist/cli.mjs https://github.com/owner/repo --sources openapi,readme

# プライベートリポジトリまたはより高いレート制限のためにGitHubトークンを使用する
GITHUB_TOKEN=ghp_xxx node packages/core/dist/cli.mjs https://github.com/owner/repo

📦 プログラム的API

独自のTypeScriptまたはJavaScriptコードでジェネレーターをインポートします。

import { GithubToMcpGenerator } from '@nirholas/github-to-mcp';

const generator = new GithubToMcpGenerator({
  githubToken: process.env.GITHUB_TOKEN,
  sources: ['openapi', 'readme', 'code', 'graphql', 'grpc', 'mcp'],
  outputLanguage: 'typescript'
});

const result = await generator.generate('https://github.com/owner/repo');

console.log(`Repository: ${result.name}`);
console.log(`Classification: ${result.classification.type}`);
console.log(`Generated ${result.tools.length} tools`);

// 生成されたコードにアクセスする
console.log(result.code);

// ディスクに保存する
await result.save('./output-directory');

interface GithubToMcpOptions {
  // API認証用のGitHubパーソナルアクセストークン
  githubToken?: string;
  
  // ツールを抽出するソース
  // デフォルト: ['openapi', 'readme', 'code', 'graphql', 'mcp']
  sources?: Array<'openapi' | 'readme' | 'code' | 'graphql' | 'grpc' | 'mcp'>;
  
  // 生成されるサーバーの出力言語
  // デフォルト: 'typescript'
  outputLanguage?: 'typescript' | 'python' | 'go';
  
  // 汎用ツール (read_file、list_filesなど) を含める
  // デフォルト: true
  includeUniversalTools?: boolean;
  
  // 生成するツールの最大数
  // デフォルト: 100
  maxTools?: number;
  
  // 分析する特定のブランチ
  // デフォルト: リポジトリのデフォルトブランチ
  branch?: string;
}

🔧 技術詳細

🏷️ リポジトリ分類

ジェネレーターは最初にリポジトリを分析し、そのタイプと構造を決定します。

1. GitHub APIからリポジトリのメタデータを取得する
2. READMEファイルをダウンロードして解析する
3. package.json、setup.py、go.modなどのマニフェストファイルを調査する
4. API仕様ファイル (openapi.json、schema.graphqlなど) をスキャンする
5. リポジトリを以下のいずれかに分類する:

分類によって、どの抽出戦略を優先するか、およびツールの名前付け方法が影響を受けます。

🔍 ツール抽出

ツールは、リポジトリ内の複数のソースから抽出されます。

🏗️ コード生成

ツールが抽出された後、ジェネレーターは以下を生成します:

1. MCPプロトコルを実装するメインサーバーファイル
2. 抽出された各ツールのツールハンドラー関数
3. すべての入力と出力スキーマの型定義
4. 必要な依存関係を含むpackage.jsonまたは同等のファイル
5. 人気のあるMCPクライアント用の設定ファイル
6. オプションのDockerデプロイメントファイル

生成されたコードは、修正することなく完全に実行可能です。

🛠️ 生成されたツール

🌐 汎用ツール

すべての生成されたMCPサーバーには、リポジトリを探索するための以下の基本ツールが含まれています:

これらのツールにより、APIや関数が検出されない場合でも、AIアシスタントはリポジトリを探索し、理解することができます。

🔧 抽出されたツール

リポジトリの内容に基づいて追加のツールが生成されます。

OpenAPI仕様から

各APIエンドポイントがツールになります。

POST /users      →  create_user(name: string, email: string)
GET /users/{id}  →  get_user(id: string)
PUT /users/{id}  →  update_user(id: string, name?: string, email?: string)
DELETE /users/{id} →  delete_user(id: string)
GET /users       →  list_users(page?: number, limit?: number)

GraphQLスキーマから

クエリとミューテーションがツールになります。

type Query {
  user(id: ID!): User         →  get_user(id: string)
  users(first: Int): [User]   →  list_users(first?: number)
}

type Mutation {
  createUser(input: CreateUserInput!): User  →  create_user(input: object)
}

Pythonコードから

@server.tool()
async def analyze_sentiment(text: str) -> str:
    """Analyze the sentiment of the given text."""
    # Implementation

これは analyze_sentiment(text: string) → "Analyze the sentiment of the given text." となります。

READMEの例から

READMEに記載されたCLIコマンド:

# Create a new project
mycli create --name myproject --template typescript

これは mycli_create(name: string, template?: string) となります。

⚙️ 設定

🔐 環境変数

GitHubトークン

トークンがない場合、GitHub APIリクエストは1時間に60回に制限されます。トークンを使用すると、制限は1時間に5,000回に増えます。プライベートリポジトリの場合、適切なアクセス権限を持つトークンが必要です。 トークンは https://github.com/settings/tokens で作成できます。

必要なスコープ:

• repo (プライベートリポジトリ用)
• public_repo (パブリックリポジトリのみ)

🎛️ ジェネレーターオプション

プログラム的APIを使用する場合、以下のように設定できます。

const generator = new GithubToMcpGenerator({
  // 認証
  githubToken: process.env.GITHUB_TOKEN,
  
  // 有効にする抽出ソース
  sources: ['openapi', 'readme', 'code', 'graphql', 'grpc', 'mcp'],
  
  // 出力設定
  outputLanguage: 'typescript', // または 'python', 'go'
  
  // ツールフィルタリング
  includeUniversalTools: true,
  maxTools: 100,
  
  // リポジトリオプション
  branch: 'main', // 分析する特定のブランチ
});

🤖 AIアシスタントとの統合

Claude Desktop

生成されたサーバーをClaude Desktopの設定に追加します。

{
  "mcpServers": {
    "my-repo": {
      "command": "node",
      "args": ["/absolute/path/to/generated/server.mjs"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxx"
      }
    }
  }
}

⚠️ 重要提示

設定を変更した後は、Claude Desktopを再起動してください。

Cursor

Cursorは設定を通じてMCPサーバーをサポートしています。CursorのMCP設定パネルにサーバーパスを追加するか、設定ファイルを直接編集します。

{
  "mcp": {
    "servers": {
      "my-repo": {
        "command": "node",
        "args": ["/path/to/server.mjs"]
      }
    }
  }
}

💻 VS Code with Continue

VS CodeのContinue拡張機能を使用する場合:

{
  "models": [...],
  "mcpServers": {
    "my-repo": {
      "command": "node",
      "args": ["/path/to/server.mjs"]
    }
  }
}

🔌 その他のMCPクライアント

MCP互換のクライアントはすべて、生成されたサーバーを使用できます。サーバーはデフォルトでstdioを介して通信し、stdinでJSON-RPCメッセージを受け取り、stdoutで応答します。 手動で実行するには:

node server.mjs

サーバーはstdinでMCPプロトコルメッセージを待ちます。

🎮 インタラクティブプレイグラウンド

Webアプリケーションには、生成されたツールをテストするためのインタラクティブなプレイグラウンドが含まれています。

1. リポジトリからツールを生成した後、「Open in Playground」をクリックする
2. ツールのリストからツールを選択する
3. 必要なパラメーターを入力する
4. 「Execute」をクリックしてツールを実行する
5. JSON応答を表示する

プレイグラウンドは、ツールをサンドボックス環境で実行し、結果をリアルタイムで表示します。

🔗 プレイグラウンドセッションの共有

生成されたツールを他の人と共有することができます。

例:

https://github-to-mcp.vercel.app/playground?gist=abc123&name=My%20API

📁 プロジェクト構造

github-to-mcp/
├── 📂 apps/
│   ├── 📂 web/                    # Next.js webアプリケーション
│   │   ├── 📂 app/                # Next.js App Routerページ
│   │   │   ├── 📂 api/            # 変換用のAPIルート
│   │   │   ├── 📂 convert/        # 変換ページ
│   │   │   ├── 📂 playground/     # インタラクティブなプレイグラウンド
│   │   │   └── 📂 dashboard/      # ユーザーダッシュボード
│   │   ├── 📂 components/         # Reactコンポーネント
│   │   ├── 📂 hooks/              # カスタムReactフック
│   │   ├── 📂 lib/                # ユーティリティ関数
│   │   └── 📂 types/              # TypeScript型定義
│   └── 📂 vscode/                 # VS Code拡張機能 (開発中)
│
├── 📂 packages/
│   ├── 📂 core/                   # 主な変換エンジン
│   │   └── 📂 src/
│   │       ├── index.ts           # GithubToMcpGeneratorクラス
│   │       ├── github-client.ts   # GitHub APIクライアント
│   │       ├── readme-extractor.ts    # README解析
│   │       ├── code-extractor.ts      # ソースコード分析
│   │       ├── graphql-extractor.ts   # GraphQLスキーマ解析
│   │       ├── mcp-introspector.ts    # 既存のMCPサーバー検出
│   │       ├── python-generator.ts    # Python出力生成
│   │       ├── go-generator.ts        # Go出力生成
│   │       └── types.ts               # 型定義
│   │
│   ├── 📂 openapi-parser/         # OpenAPI仕様パーサー
│   │   └── 📂 src/
│   │       ├── parser.ts          # OpenAPI解析ロジック
│   │       ├── analyzer.ts        # エンドポイント分析
│   │       ├── transformer.ts     # スキーマ変換
│   │       └── generator.ts       # ツール生成
│   │
│   ├── 📂 mcp-server/             # MCPサーバーユーティリティ
│   │   └── 📂 src/
│   │       ├── server.ts          # 基本的なMCPサーバー実装
│   │       └── tools.ts           # ツール登録ヘルパー
│   │
│   └── 📂 registry/               # ツールレジストリ管理
│       └── 📂 src/
│           └── index.ts           # レジストリ操作
│
├── 📂 mkdocs/                     # ドキュメントサイト (MkDocs)
│   ├── 📂 docs/                   # Markdownドキュメント
│   └── mkdocs.yml                 # MkDocs設定
│
├── 📂 tests/                      # 統合テスト
│   ├── 📂 fixtures/               # テスト用のリポジトリ
│   │   ├── 📂 express-app/        # Express.jsテストアプリ
│   │   ├── 📂 fastapi-app/        # FastAPIテストアプリ
│   │   ├── 📂 graphql/            # GraphQLテストスキーマ
│   │   └── 📂 openapi/            # OpenAPIテスト仕様
│   └── 📂 integration/            # 統合テストファイル
│
├── 📂 templates/                  # コード生成テンプレート
│   ├── Dockerfile.python.template
│   └── Dockerfile.typescript.template
│
├── package.json                   # ルートパッケージ設定
├── pnpm-workspace.yaml            # pnpmワークスペース設定
├── tsconfig.json                  # TypeScript設定
└── vitest.config.ts               # テスト設定

🔨 開発

前提条件

ローカルセットアップ

# リポジトリをクローンする
git clone https://github.com/nirholas/github-to-mcp.git
cd github-to-mcp

# 依存関係をインストールする
pnpm install

# すべてのパッケージをビルドする
pnpm build

# 開発サーバーを起動する
pnpm dev

Webアプリケーションは http://localhost:3000 で利用できます。

ビルド

# すべてのパッケージをビルドする
pnpm build

# 特定のパッケージをビルドする
pnpm --filter @nirholas/github-to-mcp build
pnpm --filter @github-to-mcp/openapi-parser build
pnpm --filter web build

テスト

# すべてのテストを実行する
pnpm test

# ウォッチモードでテストを実行する
pnpm test:watch

# カバレッジ付きでテストを実行する
pnpm test:coverage

# 特定のテストファイルを実行する
pnpm test -- tests/integration/openapi-conversion.test.ts

コード品質

# リンティングを実行する
pnpm lint

# 型チェックを実行する
pnpm typecheck

🏗️ アーキテクチャの概要

このシステムはパイプラインアーキテクチャに従っています。

Input (GitHub URL)
       │
       ▼
┌──────────────────┐
│  GitHub Client   │  リポジトリのメタデータ、ファイル、およびREADMEを取得する
└──────────────────┘
       │
       ▼
┌──────────────────┐
│   Classifier     │  リポジトリのタイプと構造を決定する
└──────────────────┘
       │
       ▼
┌──────────────────┐
│   Extractors     │  複数の抽出器が並列に実行される:
│  ├─ OpenAPI      │  • API仕様を解析する
│  ├─ GraphQL      │  • GraphQLスキーマを解析する
│  ├─ README       │  • ドキュメントから例を抽出する
│  ├─ Code         │  • ソースコードを分析する
│  └─ MCP          │  • 既存のMCPツールを検出する
└──────────────────┘
       │
       ▼
┌──────────────────┐
│  Deduplicator    │  重複するツールを削除し、類似するツールを統合する
└──────────────────┘
       │
       ▼
┌──────────────────┐
│   Validator      │  ツールスキーマを検証し、信頼度スコアを追加する
└──────────────────┘
       │
       ▼
┌──────────────────┐
│   Generator      │  ターゲット言語で出力コードを生成する
└──────────────────┘
       │
       ▼
Output (MCP Server Code + Configuration)

各抽出器は、標準化されたスキーマを持つ ExtractedTool オブジェクトのリストを生成します。重複排除器とバリデーターは、生成器が最終出力を生成する前に一貫性を確保します。

📥 サポートされている入力形式

API仕様

ソースコード言語

📤 出力形式

TypeScriptサーバー

デフォルトの出力は、公式の @modelcontextprotocol/sdk パッケージを使用するTypeScript MCPサーバーです。

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server({
  name: 'generated-server',
  version: '1.0.0',
}, {
  capabilities: {
    tools: {},
  },
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [/* 生成されたツール */],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  // ツールディスパッチロジック
});

const transport = new StdioServerTransport();
await server.connect(transport);

Pythonサーバー

Python出力は、MCP Python SDKを使用します。

from mcp.server import Server
from mcp.server.stdio import stdio_server

server = Server("generated-server")

@server.tool()
async def example_tool(param: str) -> str:
    """Tool description."""
    # 実装
    
async def main():
    async with stdio_server() as (read_stream, write_stream):
        await server.run(read_stream, write_stream)

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

設定ファイル

各生成されたサーバーには以下が含まれます。

⚠️ 制限事項

🔧 トラブルシューティング

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

🤝 コントリビューション

コントリビューションは大歓迎です！詳細なガイドラインについては CONTRIBUTING.md を参照してください。

🐛 問題の報告

問題を報告する際には、以下を含めてください。

• 問題の原因となったリポジトリのURL (公開リポジトリの場合)
• エラーメッセージまたは予期しない動作
• Node.jsとpnpmのバージョン
• オペレーティングシステム

📄 ライセンス

Apache 2.0ライセンス。詳細は LICENSE を参照してください。

🔗 リンク

Built by nich