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

一个基于Python实现的基础模型上下文协议服务器，用于教育目的。此服务器演示了MCP的核心概念以及如何在实践中使用Python进行实现。

功能特点

• 基于WebSocket的通信，采用FastAPI和WebSockets
• 使用Pydantic模型处理基本的MCP消息
• 支持模型上下文管理
• 简单的客户端-服务器交互
• 异步/等待支持以实现更好的性能

入门指南

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

python -m venv venv
source venv/bin/activate  # 在Windows上使用：venv\Scripts\activate

2. 安装依赖项：

pip install -r requirements.txt

3. 启动开发服务器：

python -m src.server

4. 运行示例客户端：

python examples/basic_usage.py

项目结构

src/
├── server.py          # 主服务器实现文件
├── types/            # TypeScript类型定义
│   └── mcp.py        # 使用Pydantic的MCP协议类型
└── examples/         # 示例实现
    └── basic_usage.py # 基本客户端示例

MCP协议概述

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

• 使用Pydantic模型处理消息格式
• 上下文管理
• 基本协议操作
• 异步/等待支持以提高性能

与TypeScript版本的主要区别

1. 使用FastAPI而不是Express
2. 实现异步/等待以获得更好的性能
3. 使用Pydantic进行数据验证和序列化
4. 更具Pythonic的代码结构和模式