AI导哈

GitHub URL处理服务器

一个用于处理GitHub URL的MCP服务器，提供URL构建、解析和智能验证功能，适用于AI应用中的GitHub操作。

  • by kongyo2
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 kongyo2/github-url-mcp

使用说明

GitHub URL MCP服务器

一个MCP（模型上下文协议）服务器，用于处理具有验证和解析功能的GitHub URL。

此服务器提供在GitHub存储库信息和URL之间进行转换的工具，并具有智能验证功能，可以区分公共存储库、私有存储库和不存在的存储库。

背景

创建此工具是为了解决LLM经常难以正确处理与GitHub相关的任务，并且无法正确调用MCP工具进行GitHub操作的问题。许多LLM难以从存储库信息构建正确的GitHub URL，解析GitHub URL以提取有意义的组件，或者知道何时使用可用的MCP工具处理GitHub相关请求。该服务器提供专门的工具，使这些操作对于人工智能应用程序来说是可靠和一致的。

注意：这个问题可能是我常用的LLM特有的，但提供专用工具可以确保不同AI系统之间的行为一致。或者，也许我应该悄悄地在克劳德·科德的最大计划中投资一大笔钱。

特性

  • URL构建：将所有者/仓库对转换为格式正确的GitHub URL
  • URL解析：从GitHub URL中提取所有者、存储库和路径信息
  • 智能存储库验证：区分公共、私有和不存在的存储库
  • 私有存储库检测：确定存储库何时存在但为私有存储库
  • 综合状态报告：存储库可访问性的明确状态指示器
  • 错误处理：无效输入的详细错误消息
  • 不要求进行验证：在没有GitHub API令牌的情况下工作
  • 超时保护：网络请求具有内置超时

工具

github/build_url

通过验证将GitHub所有者和存储库名称转换为格式正确的GitHub URL。

参数：

  • owner （string）：GitHub用户名或组织名称
  • repo （string）：存储库名称

例子：

{
  "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 （string）：要解析的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

相关 MCP