模型上下文协议服务器

一个用于教育目的的模型上下文协议服务器实现,演示了MCP的核心概念及其在Python中的实践应用。

  • by ellenfel
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ellenfel/model-context-protocol

使用说明

模型上下文协议(MCP)服务器

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

特性

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

入门指南

  1. 创建虚拟环境(推荐):
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 启动开发服务器:
python -m src.server
  1. 运行示例客户端:
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)是一种为人工智能模型交互设计的通信协议。该实施包括:

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

与TypeScript版本的主要区别

  1. 使用FastAPI而不是Express
  2. 实现async/await以获得更好的性能
  3. 使用Pydantic进行数据验证和序列化
  4. 更多Python代码结构和模式 麻省理工学院