MCP Server Example

🚀 MCP 服務器示例實現

本倉庫提供了一個用於教育目的的 Model Context Protocol (MCP) 服務器實現。該代碼展示瞭如何構建一個功能性的 MCP 服務器，使其能夠與各類 LLM 客戶端集成。

要查看完整的教程，請參考 YouTube 視頻教程。

🚀 快速開始

安裝 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  # 在 Windows 上使用：.venv\Scripts\activate

2. 安裝依賴項：

uv add "mcp[cli]" httpx

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

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

✨ 主要特性

• 擁有不斷增長的預構建集成列表，LLM 可直接插入使用。
• 具備靈活性，能輕鬆在不同 LLM 提供商和供應商之間切換。
• 遵循保護數據的最佳實踐，在您的基礎架構內運行。

📦 安裝指南

系統要求

• 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

2. 安裝依賴項：

uv add "mcp[cli]" httpx

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

touch main.py

📚 詳細文檔

什麼是 MCP？

MCP（模型上下文協議）是一項開放協議，它標準化了應用程序為 LLM 提供上下文的方式。可以將 MCP 想象成 USB - C 端口，它為 AI 應用程序提供了一種標準方式來連接到不同的數據源和工具。

架構概述

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

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

MCP 核心概念

MCP 服務器可以提供三種主要類型的功效：

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

🔧 技術細節

系統要求

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

快速入門流程

安裝 uv 包管理器

在 MacOS/Linux 上，通過 curl -LsSf https://astral.sh/uv/install.sh | sh 命令安裝 uv 包管理器，安裝後需重啟終端使 uv 命令生效。

項目設置

創建並初始化項目，創建虛擬環境並激活，安裝依賴項，創建服務器實現文件。

運行服務器

使用 uv run main.py 命令啟動 MCP 服務器。

連接到 Claude Desktop

安裝 Claude Desktop 後，編輯 ~/Library/Application Support/Claude/claude_desktop_config.json 配置文件，配置完成後重啟 Claude Desktop。

📄 許可證

此項目根據 MIT 許可證發佈。更多細節請查閱 LICENSE 文件。

💡 使用建議

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

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