MCP Server 8kh

🚀 mcp-server 中文指南

一個簡單的 MCP 服務端，允許獲取一些工具（如 langchain、openai、lama-index）的最新文檔，為開發者提供便捷的文檔獲取途徑，提升開發效率。

🚀 快速開始

系統需求

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

安裝 uv 包管理器

在 MacOS/Linux 上，可通過以下命令安裝 uv 包管理器：

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

⚠️ 重要提示： 請確保之後重啟終端，以使 uv 命令生效。

項目設置

1. 創建並初始化項目：

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

# 創建虛擬環境並激活它
uv venv
source .venv/bin/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": "/ABSOLUTE/PATH/TO/YOUR/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 日誌中的任何錯誤信息。