MCP Server Tutorial

🚀 MCP 文檔搜索服務器

該項目打造了一個自定義的 MCP（模型控制協議）服務器，能讓 Claude 通過文檔搜索，查找流行 Python 庫（如 LangChain、LlamaIndex 和 OpenAI）的相關內容。

🚀 快速開始

安裝 uv 包管理器

在 MacOS/Linux 系統，可執行以下命令：

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

在 Windows 系統，則使用以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安裝完成後，請重新啟動終端，以確保 uv 命令能被系統識別。若想了解更多關於 uv 包管理器的信息，可訪問 https://docs.astral.sh。

項目設置

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. 服務器啟動後，即可準備接受連接。

✨ 主要特性

• 可在支持的庫中搜索特定查詢的文檔。
• 通過 Serper 集成 Google Search API，查找相關文檔頁面。
• 具備網頁抓取功能，能提取文檔頁面內容。
• 專為與 Claude Desktop 配合使用而設計，可通過 MCP 進行連接。

📦 安裝指南

系統要求

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

💻 使用示例

連接到 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。

📚 詳細文檔

故障排除

若您的服務器未被 Claude Desktop 識別，可按以下步驟排查：

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