JinDaGe - github-url-mcp MCP Details

article

README

🚀 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 的最高套餐投入一大笔钱。

徽章链接说明

这些链接可能提供了与该项目相关的更多信息、服务或支持。

github-url-mcp