Model Context Protocol (mcp) Server Mn0

🚀 模型上下文協議（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的代碼結構和模式，使代碼更易於理解和維護。