[开源] 一个 Skill,让你的 Agent 访问所有开源库的源码和文档

本帖使用社区开源推广,符合推广要求。我申明并遵循社区要求的以下内容:

  • 我的帖子已经打上 开源推广 标签: 是
  • 我的开源项目完整开源,无未开源部分: 是
  • 我的开源项目已链接认可 LINUX DO 社区: 是
  • 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是
  • 以上选择我承诺是永久有效的,接受社区和佬友监督: 是

以下为项目介绍正文内容,AI生成、润色内容已使用截图方式发出


写代码的时候经常需要给 AI 贴一些库的最新文档,不然 AI 会用一些旧版的 API。特别是涉及冷门库的时候,还会出现幻觉。不过每次都手动贴文档太麻烦了,也不够灵活。此外,问 AI 一些开源项目的底层实现的时候也需要让 AI 读取源码之后回答。

我也尝试过寻找现有的工具,不过都不够满意。于是花了三天时间写了这个工具,包装成了 Skill / MCP:

  • 让 AI 能够访问所有 GitHub 开源库的源码
  • 提供搜索仓库、列出目录树、搜索代码、读取代码工具,让 AI 灵活按需读取
  • 服务端索引仓库时,会自动识别对应的文档库,并在访问主仓库时一并提供(也就是说,即使文档在另一个仓库,AI 也能够看到)
  • 完全开源、免费使用

对于 OpenCode, Codex, Cursor, Copilot 等 coding agent,只需要运行下面的命令添加 Skill:

npx skills add https://github.com/NitroRCr/gread --skill gread

对于 AI 对话应用等 MCP 客户端,可以通过 MCP 安装:

https://api.gread.dev/mcp

JSON 配置参考:

{
  "mcpServers": {
    "gread": {
      "type": "streamableHttp",
      "url": "https://api.gread.dev/mcp"
    }
  }
}

此工具也集成到了 Nya AI 中,只需要在对话中启用 “GitHub 项目” 插件即可使用。

更多信息可参考:

或者,直接添加 Skill / MCP 然后问 AI 更多细节也是可以的!

65 个赞

感谢佬友分享,很有用,马上去试试

2 个赞

这个和context7对比有什么优势嘛佬友

2 个赞

wc我还没听说过这个工具

简单看了下,好像context7主要是文档,不能读取源码?另外context7仓库需要提交之后才能访问?

4 个赞

啥原理,查看开源库源码和文档,开源库指的是github吗?

4 个赞

所有公开的github仓库。通过git部分clone至服务端。

一般开源项目的文档也会一起开源,服务端索引的时候会寻找文档仓库并关联。文档也是以源码的方式访问的。

1 个赞

这个跟deepwiki相比,有什么特别之处吗

1 个赞

主页有写:Gread

1 个赞

只能读github的开源库吗?可以读本地文件夹或其它平台源码库吗?

目前只能读 github 的库。

context7应该是api的文档;好像注册个账号就能提交。佬友这个是读源码去找api的使用方法,那会不会token的消耗更大些?哈哈哈,盲猜如果佬友提前知道context7就不开发这个了 :dog_face:

一般开源库的文档也是开源的,所以也可以直接让 AI 读文档仓库。要是知道 context7 还是会开发的,因为 context7 好像还是替代不了 Deepwiki / Zread


老哥 skill安装 没看到codex啊 我还是手动下载吧

1 个赞

有没有可能,Codex就在上面第三排 :laughing:


这是最上面啦 那个是 没看到呀,是我操作错了吗


上面的,这些 agents 都是通用 .agents/skills 目录,默认都勾选了的

Sorry, 上面已经安装完事了。下面是额外的安装,我在额外的里面再找,没有注意到这个问题

Deepwiki 有 MCP,Zread 也有 (虽然要订阅) :distorted_face:

Deepwiki 的 MCP 好像只能读 wiki。Zread 那个确实比较像,就是要付费

如果要分析开源库源码
对我来说 ask_question 和 read_wiki_contents 其实就够了
其余的直接下载放到 .repos/ 按需分析即可
还不用绕一圈透过 MCP 来用

1 个赞