★ FEATURED ARTICLE 【免费下载链接】blumeThe open-source docs framework for humans and agents.项目地址https://gitcode.com/gh_mirrors/blum/blume点击查看免费下载Blume 是一个开源文档框架The open-source docs framework for humans and agents它原生内置了MCPModel Context Protocol模型上下文协议服务器能力只需在配置里打开一行开关你的文档站就会在/mcp路径上提供一个服务器端点。随后 Claude Code、Cursor 等 AI 编程助手就能在你的编辑器里直接搜索、读取你的文档而不需要抓取网页或让读者手动粘贴 URL。整个过程不需要单独部署服务也不需要维护额外的索引。为什么文档站需要MCP服务器过去AI 编程助手想读懂你的文档通常只能靠两种方式靠 llms.txt / Markdown 镜像Blume 的每个站点默认就提供/llms.txt索引和页面 URL .md的 Markdown 副本适合静态托管场景靠 MCP 协议主动调用助手像调用 API 一样调用你文档站提供的工具能精确搜索、按内容类型过滤、拿到整页 Markdown。MCP 方案的优势在于三点助手能主动搜索search_docs工具内置独立全文索引无论你的站点用哪个搜索提供商甚至关闭了站内搜索它都能工作一次安装处处可用把服务器加入 Claude Code 或 Cursor 后每个会话都能直接访问你的文档无需每次告诉它文档地址结果可限定范围搜索和页面列表都支持按内容类型、语言、文档版本过滤。代价是MCP 服务器是实时端点必须部署在能运行服务端代码的托管平台上纯静态托管如纯静态构建不支持。如果你的文档必须留在静态托管上继续使用llms.txt Markdown 镜像即可。一键开启MCP服务器MCP 服务器默认是关闭的开启只需在 blume.config.ts 中加一小段配置agents: { mcp: { enabled: true, }, },这会把服务器挂载到/mcp。另外还有三个可选配置按需使用选项默认值说明route/mcpStreamable-HTTP 端点挂载路径name站点 title客户端显示的服务器名称instructions—传给每个连接助手的系统提示如何时该查你的文档clientstrueConnect to MCP 菜单中列出哪些客户端完整文档见 MCP server其中还介绍了按内容类型和 facets 过滤的高级用法。切换到服务端输出最关键的一步MCP 服务器实时响应请求无法打包进静态构建。如果启用了 MCP 却没有配置宿主适配器构建会直接报错BLUME_SERVER_FEATURE_REQUIRED并停止。解决方法是在 blume.config.ts 中从blume/deploy指定一个宿主适配器import { defineConfig } from blume; import { vercel } from blume/deploy; export default defineConfig({ agents: { mcp: { enabled: true, }, }, deployment: vercel(), });适配器适用宿主说明vercel()VercelBlume 自带自动识别站点 URLnetlify()Netlify需安装astrojs/netlify自动识别站点 URLcloudflare()Cloudflare Workers需安装astrojs/cloudflare需手动设置sitenode()自建 Node 服务/容器Blume 自带需手动设置site⚠️站点 URL 很重要Blume 无法自动识别 URL 时请通过node({ site: https://docs.example.com })传入。缺少站点 URL 会导致搜索结果只有裸路径而不是完整链接页面上的 Connect to MCP 菜单也会隐藏。本地验证MCP端点运行npx blume dev后服务器即刻在http://localhost:4321/mcp上线。用浏览器直接打开会看到 Method Not Allowed这是预期行为——端点只接受 MCP 协议的 POST 请求。可以用一条命令让它列出所有工具curl -s http://localhost:4321/mcp \ -H Content-Type: application/json \ -H Accept: application/json, text/event-stream \ -d {jsonrpc:2.0,id:1,method:tools/list}响应会列出四个只读工具工具返回内容search_docs匹配query的页面含标题、路由、URL、内容类型和摘要默认最多 8 条最多 20 条get_page单页完整 Markdown组件会被转成纯 Markdownlist_pages全部页面的路由、标题、描述get_navigation读者视角的页头标签和侧边栏典型检索只需两次调用先search_docs搜索关键词拿到路由后传给get_page即可得到与URL 加.md完全相同的 Markdown 全文。这些工具是只读的——助手只能读页面永远不会调用你的 API 或做任何修改。部署并连接Claude Code与Cursor提交代码并推送到远端后在 Vercel 导入仓库Node.js 22上线后服务器地址即https://docs.example.com/mcp。Blume 还会自动生成发现文档/.well-known/mcp.json并把它写进你的llms.txt让读取这两个文件的助手都能发现它。Claude Code按名称和 URL 添加claude mcp add --transport http my-docs https://docs.example.com/mcp加--scope project会写入可提交的.mcp.json整个团队共享加--scope user则在你所有项目中可用用claude mcp list确认状态为 connected会话内输入/mcp可查看服务器和工具。Cursor在项目.cursor/mcp.json或全局~/.cursor/mcp.json中添加{ mcpServers: { my-docs: { url: https://docs.example.com/mcp } } }你的读者不需要执行这些步骤只要配置了站点 URL每个页面都会出现Connect to MCP菜单一键复制 Claude Code / Codex 的安装命令或打开 Cursor / VS Code 的安装链接。你还可以通过clients选项控制菜单列出哪些客户端甚至添加自定义客户端。常见问题排查构建失败报BLUME_SERVER_FEATURE_REQUIRED构建是静态的。把deployment设置为blume/deploy中的宿主适配器如果已有适配器去掉其中的output: static。构建警告MCP 服务器未生成某个内容页或自定义页已经占用了/mcp路径。用agents.mcp.route把服务器移到别的路径并用新路径连接客户端。端点显示 Method Not Allowed说明来的是浏览器或其他发送 GET 请求的客户端服务器只响应 MCP 请求用客户端或上面的curl命令测试即可。客户端连接失败对客户端使用的确切 URL发一次tools/list请求。若也失败检查 URL 是否以你的 MCP 路由结尾、部署是否为生产域名的服务端构建、前端是否有登录保护。curl能通但客户端不通时删除后重新添加服务器。搜索结果出现其他语言的页面多语言站点的search_docs默认搜索所有语言除非助手传入locale。可以在agents.mcp.instructions中补一句请用中文返回结果。你现在拥有什么MCP 服务器与你的页面一起运行在宿主平台上数据来自构建时拍摄的文档快照——每次部署文档更新后它自动同步没有独立服务、没有需要维护的索引。官方教程 Add an MCP server to your docs 提供了从开启到部署的完整分步示例MCP 的实现源码位于 packages/blume/src/ai/mcp/相关测试在 packages/blume/test/mcp.test.ts可以深入了解协议细节。一句话总结开启一行配置 选择一个服务端宿主 粘贴一条安装命令你的文档站就成为 AI 编程助手随时可查的权威知识源 赞分享【免费下载链接】blumeThe open-source docs framework for humans and agents.项目地址https://gitcode.com/gh_mirrors/blum/blume点击查看免费下载相关推荐lanhu-mcp完整指南MCP服务器如何让蓝湖需求文档直接喂给Cursor和Claude Codelanhu mcp完整指南MCP服务器如何让蓝湖需求文档直接喂给Cursor和Claude Code lanhu mcp蓝湖MCP服务器 是一个开源的 MMCP 服务人工智能AI 应用如何让 Cursor、Claude Code 等 MCP 客户端连接 Mem0 托管 MCP 服务器如何让 Cursor、Claude Code 等 MCP 客户端连接 Mem0 托管 MCP 服务器 AI 编码客户端Cursor、Claude Code 等人工智能AI AgentAgent 记忆RAGHermes 接入 DeepSeek 快速教程2 分钟装好5 步走完配置Hermes 接入 DeepSeek 快速教程2 分钟装好5 步走完配置 很多新手第一次给 Hermes 接 DeepSeek卡在 API Key、Bas教程大模型AI Agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
