MCP Server Python

🚀 MCP 服務器示例

本倉庫包含實現模型上下文協議（MCP）的服務器代碼，展示瞭如何構建功能完備的 MCP 服務器，該服務器可與多個語言模型客戶端（LLM）集成。

🚀 快速開始

系統要求

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

安裝包管理器 uv

在 macOS/Linux 系統中，執行以下命令：

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

在 Windows 系統中，執行以下命令：

iwr -useb https://astral.sh/uv/install.ps1 | iex

安裝完成後，請重新啟動終端，確保 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

配置 Claude Desktop

若要將 MCP 服務器與 Claude Desktop 集成，請按以下步驟操作：

1. 打開 Claude 的設置菜單。
2. 導航至集成選項。
3. 添加 MCP 服務器配置，指定路徑 /ruta/absoluta/para/tu/mcp-server。

示例命令

# 啟動 MCP 服務器
uv run main.py

✨ 主要特性

什麼是 MCP？

MCP（Model Context Protocol）是一個開放協議，它標準化了應用程序向語言模型提供上下文的方式。MCP 如同 AI 應用程序的“USB - C 端口”，以標準方式連接不同的數據源和工具與 AI 模型。

關鍵優勢

• 擁有快速增長的預構建集成列表，可直接用於你的 LLM。
• 具備靈活性，可在不同 LLM 供應商和提供商之間切換。
• 遵循保護數據的最佳實踐。

🔧 技術細節

架構概述

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

• MCP 主機：如 Claude Desktop、IDE 或其他 AI 工具，是希望通過 MCP 訪問數據的應用程序。
• MCP 客戶端：維護與服務器單線聯繫的協議客戶端。
• MCP 服務器：提供特定功能（如文件訪問或 API 調用）的輕量級程序。
• 數據源：可以是本地文件、數據庫或遠程服務（API 等），供 MCP 服務器訪問。

MCP 關鍵概念

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

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

📄 聯繫方式

如有任何問題或反饋，請通過以下方式聯繫：

• 郵箱：[你的郵箱地址]
• LinkedIn：[你的 LinkedIn 鏈接]

愉快編碼！🚀

如果你發現這個項目有用，請在 GitHub 上給我點個星星 😊