Inkeep MCP

🚀 Inkeep MCP：通用文档桥梁

Inkeep MCP 是一个解锁任意由 Inkeep 驱动的文档站点 “询问 AI” 功能的工具。它能将你的本地 AI 代理直接连接到 Langfuse、Render、Clerk 等众多官方文档。

English | 中文

Inkeep MCP 是一个基于 模型上下文协议（MCP） 构建的通用连接器。它弥合了本地 AI 工具（如 Gemini CLI、Claude Desktop）与现代文档站点 “询问 AI” 按钮背后隐藏的大量知识之间的差距。

它模拟浏览器访问 Inkeep 的服务，让你无需官方 API 密钥或手动配置，就能查询 任何 受支持的站点。

🚀 快速开始

📦 安装指南

git clone https://github.com/xu-xiang/inkeep-mcp.git
cd inkeep-mcp
pip install -r requirements.txt

💻 使用示例

基础用法（CLI 人类模式）

你可以将其作为独立的 CLI 工具，从终端查询文档。

# 向 Langfuse 文档提问
python3 cli.py ask langfuse "How do I trace LangChain chains?"

# 与 Render 文档开启交互式聊天会话
python3 cli.py chat render

# 添加新的文档源
python3 cli.py add supabase https://supabase.com/docs --desc "Supabase Docs"

高级用法（MCP 集成 - 代理模式）

赋予你的 AI 助手阅读文档的能力。

Gemini CLI

在 ~/.gemini/config.json 中添加以下内容：

{
  "mcpServers": {
    "inkeep": {
      "command": "python3",
      "args": ["/absolute/path/to/inkeep-mcp/mcp_server.py"],
      "env": {"PYTHONUNBUFFERED": "1"}
    }
  }
}

Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "inkeep": {
      "command": "python3",
      "args": ["/absolute/path/to/inkeep-mcp/mcp_server.py"]
    }
  }
}

✨ 主要特性

问题：知识受限

顶级开发工具（如 Langfuse、Render、Neon 等）使用 Inkeep 来提供出色的 AI 搜索功能。但此功能被锁定在浏览器小部件中。

• 开发者 不得不离开终端进行搜索。
• AI 代理（如 Gemini/Claude）无法以编程方式访问这个高质量、最新的知识库。

解决方案：通用桥梁

该工具 “解放” 了这些知识。它充当通用适配器，具备以下功能：

1. 扫描：在目标网站（任何网站！）中搜索 Inkeep 配置。
2. 连接：使用网站自身的公共凭证（模拟访客）进行连接。
3. 流式传输：将答案流式传输回你的 CLI 或代理。

结果：你的 AI 代理能够 “读取” 任何使用 Inkeep 的产品的官方文档。

🔧 技术细节

工作原理

1. 注册表：维护别名（如 langfuse）到 URL（如 https://langfuse.com）的本地映射。启动时会自动与最新的内置默认设置同步。
2. 提取：连接到新网站时，模拟浏览器请求，扫描前端 JS 包以查找嵌入的 Inkeep 配置。
3. 认证：向 Inkeep 请求挑战，并在本地解决 SHA - 256 工作量证明。
4. 查询：将问题流式传输到 Inkeep 的问答专家模型，并将结果返回给你的代理。

📦 支持的站点

由我们的挖掘器自动发现：

• Langfuse（Langfuse（LLM 工程平台）官方文档）
• Render（Render（云托管）官方文档）
• Clerk（Clerk（身份验证）官方文档）
• Neon（Neon（无服务器 Postgres）官方文档）
• Teleport（Teleport（访问平面）官方文档）
• React（用于 Web 和原生用户界面的库）
• Bootstrap（最流行的 HTML、CSS 和 JavaScript 开发框架）
• Ragflow（RAGFlow 是领先的开源检索增强生成工具）
• Node（运行你自己的基础节点所需的一切）
• Socket-io（实时应用程序框架（Node.JS 服务器））
• Sway（🌴 让每个人都能构建可靠高效的智能应用）
• Bun（极快的 JavaScript 运行时、打包器、测试运行器和包管理器）
• Zod（基于 TypeScript 的模式验证，支持静态类型推断）
• Novu（开源通知收件箱基础设施，支持电子邮件、短信和推送）
• Litellm（Python SDK、代理服务器（AI 网关），可调用 100 多个大语言模型 API）
• Posthog（🦔 PostHog 是一个一体化的开发者平台，用于构建产品）
• Goose（一个开源的、可扩展的 AI 代理，超越代码建议）
• Frigate（用于 IP 摄像头的实时本地目标检测的网络视频录像机）
• Fingerprintjs（最先进的免费开源浏览器指纹识别工具）
• Spacetimedb（光速级别的多人游戏体验）
• Nextra（基于 Next.js 的简单、强大且灵活的站点生成框架）
• Zitadel（ZITADEL - 简化的身份基础设施）
• Opal（策略和数据管理、分发和实时处理）
• Javascript（Clerk 身份验证的官方 JavaScript 仓库）
• Vectordbbench（向量数据库基准测试工具）
• Eon（用于实时数据的开源图表和地图框架）
• Kit（Solana JavaScript SDK）
• Lemonsqueezy-js（Lemon Squeezy 的官方 JavaScript SDK）

...以及你通过 cli.py add 添加的任何其他站点！

🤝 贡献代码

我们欢迎贡献！

1. 分叉仓库。
2. 在 extractor.py 中添加对更多静态站点生成器的支持。
3. 提交拉取请求。

📄 许可证

本项目采用 MIT 许可证。