Github Url MCP

🚀 GitHub URL MCP Server

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

🚀 クイックスタート

このサーバーは、GitHubのURLを検証し解析するためのMCPサーバーです。AIアプリケーションに対して、GitHub関連の操作を信頼性高く一貫して行うための専用ツールを提供します。

✨ 主な機能

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

📚 ドキュメント

背景

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

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

ツール

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