MCP Python

🚀 MCP 服务器演示

本项目是一个 Model Context Protocol (MCP) 服务器的演示实现，MCP 协议为客户端与 AI 模型之间的通信提供了标准化方式，可用于交换提示、上下文和模型响应，具有重要的应用价值。

🚀 快速开始

本项目旨在展示如何使用 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 .
   

💻 使用示例

基础用法

运行服务器：

python main.py

服务器将在默认端口上开始监听客户端连接。

📚 详细文档

项目结构

• 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 日