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

本项目是一个基于Python实现的基础模型上下文协议服务器，专为教育目的打造。它清晰地展示了MCP的核心概念，同时详细说明了如何运用Python在实际场景中进行实现。

🚀 快速开始

环境准备

创建虚拟环境（推荐）：

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

依赖安装

pip install -r requirements.txt

启动服务器

python -m src.server

运行示例客户端

python examples/basic_usage.py

✨ 主要特性

• 基于WebSocket的通信，采用FastAPI和WebSockets技术。
• 使用Pydantic模型处理基本的MCP消息，确保消息处理的准确性和规范性。
• 支持模型上下文管理，方便对模型的上下文信息进行有效管理。
• 实现简单的客户端 - 服务器交互，便于开发者进行测试和调试。
• 提供异步/等待支持，有效提升服务器的性能。

📚 详细文档

项目结构

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

MCP协议概述

模型上下文协议（MCP）是一种用于AI模型交互的通信协议。此实现涵盖以下方面：

• 使用Pydantic模型处理消息格式，保证消息格式的统一和规范。
• 具备上下文管理功能，可对模型的上下文信息进行灵活管理。
• 支持基本协议操作，满足常见的通信需求。
• 采用异步/等待支持，显著提高协议的性能。

与TypeScript版本的主要区别

1. 使用FastAPI而不是Express，提供更高效的Web框架支持。
2. 实现异步/等待以获得更好的性能，提升服务器的响应速度。
3. 使用Pydantic进行数据验证和序列化，确保数据的准确性和一致性。
4. 拥有更具Pythonic的代码结构和模式，使代码更易于理解和维护。