GitHub URL MCP服务器
](https://smithery.ai/server/@kongyo2/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 startCLI交互开发模式
npm run dev测试
npm run test装订和格式化
npm run lint
npm run format构建
npm run build