MCP Python

🚀 MCP 服務器演示

本項目是一個 Model Context Protocol (MCP) 服務器的演示實現。MCP 協議為客戶端與 AI 模型之間的通信搭建橋樑，提供了標準化的提示、上下文與模型響應的交換方式。

🚀 快速開始

運行服務器，只需執行以下命令：

python main.py

服務器將在默認端口上開始監聽客戶端連接。

✨ 主要特性

• 本項目利用 FastMCP 框架實現了一個 Model Context Protocol (MCP) 服務器。
• 服務器提供文件操作工具，如創建、讀取、刪除和搜索文件。
• 具備動態資源，可提供個性化的問候。
• 展示瞭如何利用 MCP 實現客戶端與 AI 模型之間的高效通信。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• pip 或 uv 包管理器

設置步驟

1. 克隆此倉庫。
2. 創建虛擬環境：

   python -m venv .venv
   

3. 激活虛擬環境：
   • Windows: .venv\Scripts\activate
   • Unix/macOS: source .venv/bin/activate
4. 安裝依賴項：

   pip install -e .
   

📚 詳細文檔

項目結構

• main.py：應用程序的入口點。
• pyproject.toml：項目配置和依賴項。
• uv.lock：依賴項鎖定文件。

API

該服務器實現了 Model Context Protocol 規範，具體包括：

• 模型交互的請求/響應格式。
• 上下文管理。
• 身份驗證機制。
• 速率限制。

實現的功能

動態問候資源：@mcp.resource("greeting://{name}")

根據給定的名字提供個性化的問候。

文件操作工具

• list_files(directory_path: str) -> List[str]：列出指定目錄中的所有文件。
• create_file(file_path: str, content: str = "") -> str：創建具有可選初始內容的新文件。
• add_to_file(file_path: str, content: str) -> str：向現有文件追加內容。
• read_file(file_path: str) -> str：讀取並返回文件的內容。
• delete_file(file_path: str) -> str：刪除指定的文件。
• search_in_file(file_path: str, search_term: str) -> str：在文件中搜索術語，並返回匹配的行。
• rename_file(old_path: str, new_path: str) -> str：重命名或移動文件。

最後更新信息

最後一次更新：2025 年 4 月 24 日