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 日