🔓 Inkeep MCP：通用文档桥
从任何支持Inkeep的文档网站解锁“Ask AI”功能。将您当地的AI Agent直接连接到Langfuse、Render、Clerk和无数其他人的官方文档。
Inkeep MCP 是一种基于 模型上下文协议（MCP）。它弥合了本地AI工具（Gemini CLI、Claude Desktop）与现代文档网站上“Ask AI”按钮背后隐藏的丰富知识之间的差距。
它模拟浏览器访问Inkeep的服务，允许您查询 任何 支持的网站，无需官方API密钥或手动配置。
______________________________________________________________________
🧐 “为什么”
问题：锁定的知识
顶级开发工具（Langfuse、Render、Neon…）使用 Inkeep 为他们出色的人工智能搜索提供动力。但这种功能被锁定在他们的浏览器小部件中。
- 开发者 必须离开他们的终端进行搜索。
- AI代理 （Gemini/Claude）无法以编程方式访问这个高质量、最新的知识库。
解决方案：一座通用桥梁
这个工具“解放”了这种知识。它充当通用适配器：
- 扫描 Inkeep配置的目标网站（任何网站！）。
- 连接 使用网站自己的公共凭据（模拟访问者）。
- 流 将答案返回给CLI或Agent。
结果：您的AI Agent可以“阅读”任何使用Inkeep的产品的官方文档。
______________________________________________________________________
🚀 入门指南
安装
git clone https://github.com/xu-xiang/inkeep-mcp.git
cd inkeep-mcp
pip install -r requirements.txtCLI使用（人工模式）
您可以将其用作独立的CLI工具，从终端查询文档。
# Ask a question to Langfuse docs
python3 cli.py ask langfuse "How do I trace LangChain chains?"
# Start an interactive chat session with Render docs
python3 cli.py chat render
# Add a new documentation source
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"}
}
}
}克劳德桌面版
添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"inkeep": {
"command": "python3",
"args": ["/absolute/path/to/inkeep-mcp/mcp_server.py"]
}
}
}📖 工作原理
- 注册表：维护本地别名地图(
langfuse)到URL(https://langfuse.com).启动时，它会自动与最新的内置默认值同步。 - 提取：当连接到新站点时，它会模拟浏览器请求，扫描前端JS包以查找嵌入式Inkeep配置。
- 认证：它向Inkeep请求挑战，并在本地解决SHA-256 PoW。
- 查询：它将问题流式传输到Inkeep的QA专家模型，并将结果返回给您的代理。
📦 支持站点
*我们的矿工发现的汽车：*
- 浪伏 （Langfuse（LLM工程平台）官方文件）
- 渲染 （渲染（云托管）官方文档）
- 职员 （办事员（认证）正式文件）
- 霓虹 （Neon（无服务器Postgres）官方文档）
- 传送 （Teleport（Access Plane）官方文件）
- 反应 （用于web和本机用户界面的库。）
- 独自创立 （最流行的HTML、CSS和JavaScript开发框架）
- Ragflow 的 （RAGFlow是领先的开源检索增强生成器）
- 节点 （运行自己的Base节点所需的一切）
- 插座io （实时应用框架（Node.JS服务器））
- 摇摆 (🌴 使每个人都能构建可靠高效的智能）
- 包子 （令人难以置信的快速JavaScript运行时、打包器、测试运行器和包管理器。）
- 黄道带 （TypeScript首次使用静态类型推理进行模式验证。）
- 新建 （开源通知收件箱基础设施。电子邮件、短信和推送。）
- 轻量级语言模型 （Python SDK，代理服务器（AI网关）调用100多个LLM API。)
- 邮猪 (🦔 PostHog是一个用于构建产品的一体化开发平台。)
- 鹅 （一个开源、可扩展的AI代理，超越了代码建议。）
- 护卫舰 （NVR，用于IP摄像机的实时本地对象检测。）
- 指纹js （最先进的免费和开源浏览器指纹识别。）
- Spacetimedb （以光速进行多人游戏。）
- Nextra （简单、强大、灵活的Next.js网站生成框架。）
- 标题 （ZITADEL-身份基础设施，为您简化。）
- 欧泊 （策略和数据管理、分发和实时）
- JavaScript （用于Clerk身份验证的官方JavaScript存储库）
- 矢量基准 （矢量数据库的基准。）
- 亿年 （一个用于实时数据的开源图表和地图框架。）
- 套件 （Solana JavaScript SDK）
- Lemonsqueezy js （Lemon Squeezy的官方JavaScript SDK。）
*…以及您通过添加的任何其他网站 cli.py add!*
🤝 贡献
我们热爱贡献！
- 分叉回购。
- 在中添加对更多静态站点生成器的支持
extractor.py. - 提交拉取请求。
📄 许可证
MIT许可证。
