用途:访问 GitHub 仓库文档与代码,基于 gitmcp.io 的 MCP 服务实现。适用时机:用户提供 GitHub URL,或提到某个具体仓库时。
URL 转换:将 github.com/owner/repo 转为 gitmcp.io/owner/repo,例如 https://github.com/karpathy/llm-council 对应 https://gitmcp.io/karpathy/llm-council。
CLI 用法(scripts/gitmcp.py):列出可用工具:python3 scripts/gitmcp.py list-tools owner/repo;获取完整文档:python3 scripts/gitmcp.py fetch-docs owner/repo;文档语义搜索:python3 scripts/gitmcp.py search-docs owner/repo "query";代码精确搜索(GitHub Search API):python3 scripts/gitmcp.py search-code owner/repo "function_name";抓取文档中引用的 URL:python3 scripts/gitmcp.py fetch-url owner/repo "https://example.com/doc";直接调用任意 MCP 工具:python3 scripts/gitmcp.py call owner/repo tool_name '{"arg": "value"}'。
工具名会以仓库名加下划线动态前缀,例如 karpathy/llm-council 对应 fetch_llm_council_documentation,facebook/react 对应 fetch_react_documentation,my-org/my-repo 对应 fetch_my_repo_documentation。可用 MCP 工具包括:fetch_{repo}documentation(获取全部文档,一般问题先调用)、search{repo}documentation(文档内语义搜索)、search{repo}_code(经 GitHub API 精确匹配代码,返回匹配文件)、fetch_generic_url_content(抓取文档中引用的任意 URL,遵守 robots.txt)。
工作流:拿到仓库后先获取文档了解项目;具体使用或功能问题用 search-docs;查找实现或函数用 search-code;需要外部参考时用 fetch-url。
限制:资料未提供收费、平台与运行环境等细节;代码搜索为精确匹配,文档检索依赖 gitmcp.io 服务可用性。