Github URL MCP

🚀 GitHub URL MCP Server

GitHubのURLを検証と解析機能を持って処理するためのMCP（Model Context Protocol）サーバーです。このサーバーは、GitHubリポジトリ情報とURLの相互変換ツールを提供し、公開リポジトリ、プライベートリポジトリ、存在しないリポジトリを区別するためのインテリジェントな検証機能も備えています。

🚀 クイックスタート

このサーバーは、GitHub URLを検証し解析するためのMCPサーバーです。GitHubリポジトリ情報とURLの相互変換が可能で、公開リポジトリ、プライベートリポジトリ、存在しないリポジトリを区別することができます。

✨ 主な機能

• URL生成：オーナー名とリポジトリ名のペアを適切にフォーマットされたGitHub URLに変換します。
• URL解析：GitHub URLからオーナー名、リポジトリ名、パス情報を抽出します。
• スマートなリポジトリ検証：公開リポジトリ、プライベートリポジトリ、存在しないリポジトリを区別します。
• プライベートリポジトリ検出：リポジトリが存在しているがプライベートであることを識別します。
• 包括的なステータス報告：リポジトリのアクセス可能性に関する明確なステータスインジケーターを提供します。
• エラーハンドリング：無効な入力に対する詳細なエラーメッセージを提供します。
• 認証不要：GitHub APIトークンなしで動作します。
• タイムアウト保護：ネットワークリクエストには組み込みのタイムアウトが設定されています。

📚 ドキュメント

ツール

github/build_url

GitHubのオーナー名とリポジトリ名を検証付きで適切にフォーマットされたGitHub URLに変換します。

パラメータ:

• owner (文字列): GitHubのユーザー名または組織名
• repo (文字列): リポジトリ名

例:

{
  "owner": "microsoft",
  "repo": "vscode"
}

戻り値:

• https://github.com/microsoft/vscode (公開リポジトリの場合)
• https://github.com/owner/repo + 🔒 注意 (プライベートリポジトリの場合)
• https://github.com/owner/repo + ⚠️ 警告 (存在しないリポジトリの場合)
• https://github.com/owner/repo + ❌ エラー (検証エラーの場合)

github/parse_url

GitHub URLを解析して、検証付きでオーナー名、リポジトリ名、追加のパス情報を抽出します。

パラメータ:

• url (文字列): 解析するGitHub URL

例:

{
  "url": "https://github.com/microsoft/vscode/tree/main/src"
}

戻り値:

{
  "owner": "microsoft",
  "repo": "vscode",
  "url": "https://github.com/microsoft/vscode",
  "additionalPath": "tree/main/src",
  "status": "public",
  "accessible": true
}

ステータス値:

• "public": リポジトリは公開アクセス可能です。
• "private": リポジトリは存在するがプライベートです。
• "not_found": リポジトリは存在しません。
• "error": 検証エラーが発生しました。

追加フィールド:

• accessible: リポジトリが公開アクセス可能かどうかを示すブール値
• note: プライベートリポジトリに関する情報メッセージ
• warning: 存在しないリポジトリに関する警告メッセージ
• error: 検証失敗に関するエラーメッセージ

📦 インストール

セットアップ

npm install

サーバーの起動

npm run start

CLIでの開発モード

npm run dev

テスト

npm run test

リントとフォーマット

npm run lint
npm run format

ビルド

npm run build

🔧 技術詳細

このツールは、LLMがGitHub関連のタスクを適切に処理できず、GitHub操作のためのMCPツールを適切に呼び出せない問題を解決するために作成されました。多くのLLMは、リポジトリ情報から正しいGitHub URLを構築したり、GitHub URLを解析して意味のあるコンポーネントを抽出したり、GitHub関連のリクエストに利用可能なMCPツールを使用するタイミングを把握することが困難です。このサーバーは、これらの操作をAIアプリケーションにとって信頼性が高く一貫したものにする専用ツールを提供します。

注: この問題は私が一般的に使用するLLMに特有のものかもしれませんが、専用ツールを提供することで、さまざまなAIシステム間で一貫した動作が保証されます。あるいは、Claude Codeの最大プランに大金を投資するだけでいいのかもしれません。