Github Url MCP

🚀 GitHub URL MCP Server

GitHub URL MCP Server 是一個基於 MCP（模型上下文協議）的服務器，具備驗證和解析功能，可用於處理 GitHub URL。它提供了一系列工具，能在 GitHub 倉庫信息和 URL 之間進行轉換，並通過智能驗證區分公共倉庫、私有倉庫和不存在的倉庫。

🚀 快速開始

環境搭建

npm install

啟動服務器

npm run start

開啟帶 CLI 交互的開發模式

npm run dev

測試

npm run test

代碼檢查與格式化

npm run lint
npm run format

構建

npm run build

✨ 主要特性

• 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：驗證失敗的錯誤消息。

🔧 技術細節

背景

此工具的創建是為了解決大語言模型（LLMs）在處理與 GitHub 相關任務時經常遇到的問題。許多 LLMs 難以根據倉庫信息構建正確的 GitHub URL，難以解析 GitHub URL 以提取有意義的組件，或者不知道何時使用可用的 MCP 工具進行與 GitHub 相關的請求。該服務器提供了專門的工具，使這些操作對於 AI 應用程序來說更加可靠和一致。

注意：這個問題可能特定於我常用的 LLMs，但提供專用工具可確保不同 AI 系統的行為一致。或者，也許我應該悄悄為 Claude Code 的最高套餐投入一大筆錢。

徽章鏈接說明

• 
• 
• 這些鏈接可能提供了與該項目相關的更多信息、服務或支持。