Github URL MCP

🚀 GitHub URL MCP 服務器

這是一個用於處理 GitHub URL 的 MCP（模型上下文協議）服務器，具備驗證和解析功能。它能解決大語言模型（LLMs）在處理 GitHub 相關任務時的難題，為 AI 應用提供可靠且一致的操作工具。

🚀 快速開始

本服務器提供了將 GitHub 倉庫信息與 URL 相互轉換的工具，具備智能驗證功能，可區分公共倉庫、私有倉庫和不存在的倉庫。

✨ 主要特性

• URL 構建：將所有者/倉庫對轉換為格式正確的 GitHub URL。
• URL 解析：從 GitHub URL 中提取所有者、倉庫和路徑信息。
• 智能倉庫驗證：區分公共、私有和不存在的倉庫。
• 私有倉庫檢測：識別存在但為私有的倉庫。
• 全面狀態報告：為倉庫可訪問性提供清晰的狀態指示。
• 錯誤處理：為無效輸入提供詳細的錯誤消息。
• 無需身份驗證：無需 GitHub API 令牌即可工作。
• 超時保護：網絡請求內置超時機制。

📦 安裝指南

環境搭建

npm install

啟動服務器

npm run start

開發模式（帶 CLI 交互）

npm run dev

測試

npm run test

代碼檢查與格式化

npm run lint
npm run format

構建

npm run build

💻 使用示例

基礎用法

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 的最高套餐投入一大筆錢。

工具說明

github/build_url

將 GitHub 所有者和倉庫名稱轉換為格式正確的 GitHub URL 並進行驗證。

github/parse_url

解析 GitHub URL 以提取所有者、倉庫名稱和附加路徑信息並進行驗證。

開發說明

環境搭建

使用 npm install 安裝依賴。

啟動服務器

使用 npm run start 啟動服務器。

開發模式

使用 npm run dev 進入開發模式，支持 CLI 交互。

測試

使用 npm run test 運行測試。

代碼檢查與格式化

使用 npm run lint 進行代碼檢查，使用 npm run format 進行代碼格式化。

構建

使用 npm run build 進行構建。

引用鏈接