MCP Server For Documentation

🚀 文檔 MCP 服務器

本倉庫實現了一個模型上下文協議（MCP）服務器。該服務器可依據給定的查詢和庫來搜索最新文檔，支持 langchain、openai 和 llama - index 等工具，能為用戶提供文檔中的文本內容。

🚀 快速開始

系統要求

• Python 3.10 或更高版本
• MCP SDK 1.2.0 或更高版本
• uv 包管理器

安裝 uv 包管理器

在 MacOS/Linux 上，可使用以下命令進行安裝：

curl -LsSf https://astral.sh/uv/install.sh | sh

請確保之後重新啟動終端，以便系統識別 uv 命令。

項目設置

1. 創建並初始化項目：

# 創建一個新目錄用於我們的項目
uv init mcp-server
cd mcp-server

# 創建虛擬環境並激活它
uv venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

# 安裝依賴項
uv add "mcp[cli]" httpx

2. 創建服務器實現文件：

touch main.py

運行服務器

1. 啟動 MCP 服務器：

uv run main.py

2. 服務器將啟動並準備好接受連接

連接到 Claude Desktop

1. 從官方網站安裝 Claude Desktop。
2. 配置 Claude Desktop 使用您的 MCP 服務器： 編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # 使用 uv 命令的絕對路徑更好
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. 重啟 Claude Desktop

✨ 主要特性

功能概述

該 MCP 服務器可根據給定的查詢和庫搜索最新的文檔，支持 langchain、openai 和 llama - index。其輸入參數為查詢內容（如“Chroma DB”）和要搜索的庫（如“langchain”），輸出為文檔中的文本。

關鍵優勢

• 擁有不斷增長的預構建集成列表，您的 LLM 可以直接連接。
• 在切換 LLM 提供商和供應商時具有靈活性。
• 在基礎設施中遵循保護數據的最佳實踐。

🔧 技術細節

什麼是 MCP？

MCP（模型上下文協議）是一個開放協議，它標準化了應用程序如何向大語言模型（LLM）提供上下文。可以將 MCP 類比為 USB - C 接口，它為 AI 應用程序提供了一種標準方式來連接不同的數據源和工具。

架構概述

MCP 採用客戶機 - 服務器架構，主機應用程序可以連接到多個服務器：

• MCP 主機：如 Claude Desktop、IDE 或 AI 工具，這些程序希望通過 MCP 訪問數據。
• MCP 客戶端：維護與服務器 1:1 連接的協議客戶端。
• MCP 服務器：通過標準化模型上下文協議暴露特定功能的輕量級程序。
• 數據源：包括本地（文件、數據庫）和遠程服務（API）等，MCP 服務器可以訪問。

核心 MCP 概念

MCP 服務器可以提供三種主要能力類型：

• 資源：類似文件的數據，客戶端可以讀取（如 API 響應或文件內容）。
• 工具：LLM 可以調用的函數（需要用戶批准）。
• 提示：幫助用戶完成特定任務的預寫模板。

📚 詳細文檔

故障排除

如果您的服務器未被 Claude Desktop 檢測到，可以按以下步驟排查：

1. 檢查配置文件路徑和權限。
2. 確保配置中的絕對路徑正確。
3. 確保 uv 已正確安裝並可訪問。
4. 查看 Claude Desktop 日誌中的任何錯誤消息。