Model Context Protocol (MCP) Server

模型上下文协议（MCP）服务

这是一个出于教学目的而实现的基础模型上下文协议服务。该服务展示了 MCP 的核心概念，以及如何使用 Python 在实践中实现这些概念。

功能

• 使用 FastAPI 和 WebSockets 进行基于 WebSocket 的通信
• 使用 Pydantic 模型处理基本 MCP 消息
• 支持模型上下文管理
• 简单的客户端-服务端交互
• 支持 async/await，以提升性能

快速开始

1. 创建虚拟环境（推荐）：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

2. 安装依赖：

pip install -r requirements.txt

3. 启动开发服务：

python -m src.server

4. 运行示例客户端：

python examples/basic_usage.py

项目结构

src/
├── server.py          # Main server implementation
├── types/            # TypeScript type definitions
│   └── mcp.py        # MCP protocol types using Pydantic
└── examples/         # Example implementations
    └── basic_usage.py # Basic client example

MCP 协议概述

模型上下文协议（MCP）是一种专为 AI 模型交互设计的通信协议。此实现包括：

• 使用 Pydantic 模型处理消息格式
• 上下文管理
• 基本协议操作
• 支持 async/await，以提升性能

与 TypeScript 版本的主要区别

1. 使用 FastAPI，而非 Express
2. 实现 async/await，以提升性能
3. 使用 Pydantic 进行数据验证和序列化
4. 代码结构和模式更符合 Python 风格 MIT