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 許可證。