关于 ByJG Open Source Docs
ByJG Docs MCP Server 为 AI 助手提供 ByJG 开源项目文档的语义搜索,并可引用来源页面。它面向使用 ByJG 库的用户,支持检索段落和读取完整页面。
主要功能
- 01语义搜索文档
- 02搜索结果附来源网址
- 03获取完整 Markdown 页面
- 04列出已索引项目
适用场景
- 01查找 ByJG 库的使用说明
- 02查询 TableAttribute 等确切符号
- 03阅读完整文档页面
MCP 相关
它通过 Streamable HTTP 向 MCP 客户端提供文档搜索、页面读取和项目清单工具,地址为 https://mcpdocs.byjg.com/mcp。公共端点无需身份验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcpdocs.byjg.com/mcpclaude mcp add --transport http com-byjg-docs https://mcpdocs.byjg.com/mcp{"mcpServers":{"com-byjg-docs":{"type":"http","url":"https://mcpdocs.byjg.com/mcp"}}}在 Cursor 中打开{"servers":{"com-byjg-docs":{"type":"http","url":"https://mcpdocs.byjg.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-byjg-docs":{"type":"http","url":"https://mcpdocs.byjg.com/mcp"}}}{"mcpServers":{"com-byjg-docs":{"serverUrl":"https://mcpdocs.byjg.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | |
| query | string | 是 | |
| project | any | 否 | |
| category | any | 否 |
详细介绍
sidebar_key: mcpserver-byjg-docs tags: [ai, python, docker]
ByJG Docs MCP 服务
一个 MCP 服务,为 AI 助手提供 ByJG 所有开源项目文档的语义搜索功能——这些内容也发布在 opensource.byjg.com。
连接助手后,它便可以回答有关 ByJG 库(MicroOrm、RestServer、Gluo、EasyHAProxy 等)的疑问,并引用每个答案所依据的文档页面。
端点
| URL | https://mcpdocs.byjg.com/mcp |
| 传输方式 | Streamable HTTP |
| 身份验证 | 无——文档是公开的,因此无需令牌 |
URL 必须以 /mcp 结尾。
大多数客户端都接受这种格式;具体的文件和键因客户端而异:
{
"mcpServers": {
"byjg-docs": {
"url": "https://mcpdocs.byjg.com/mcp"
}
}
}
要运行自己的副本?也可以要求提供 bearer token—— 请参阅身份验证。
将其添加到客户端
| 客户端 | 设置 | 一键安装 |
|---|---|---|
| Claude Code (CLI) | 说明 | |
| Claude Desktop | 说明 | |
| Codex CLI | 说明 | |
| GitHub Copilot CLI | 说明 | |
| Gemini CLI | 说明 | |
| OpenCode | 说明 | |
| Cursor | 说明 | |
| VS Code | 说明 | |
| VS Code Insiders | 说明 | |
| Visual Studio | ||
| JetBrains IDEs | 说明 | |
| Goose | ||
| LM Studio |
一键安装徽章会将端点直接交给客户端,然后客户端会要求你确认;其他方式则是在客户端页面中手动配置。连接问题请参阅: 故障排除。
这两种方式都不会从注册表安装。该服务已在官方 MCP Registry 中发布,名称为 com.byjg/docs,供发现和验证来源之用:请参阅 MCP Registry 条目。
工具
| 工具 | 用途 |
|---|---|
search_docs(query, limit, category, project) | 排序后的段落,每个段落都附有其公开 URL |
get_document(source_path) | 获取单个页面的完整 Markdown |
list_projects() | 查看已索引内容清单 |
query 接受自然语言(“如何将表映射到类”)或确切的符号名称(TableAttribute)——两者都可以。详见工具详情。
隐私
服务会记录每次工具调用——包括查询、筛选条件,以及文档的匹配度——以发现文档尚未涵盖的内容。日志保留在服务端,不会共享。请勿在查询中填写机密信息。
开发
如需自行运行服务、自托管或修改代码,请参阅开发。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。