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 进行构建。

引用链接