模型上下文协议服务器

一个基于 FastAPI 实现的模型上下文协议（MCP）服务器，负责处理模型上下文管理、会话处理和协议操作。

功能特性

• 基于 FastAPI 的 REST API 服务器
• 模型上下文管理
• 会话处理与持久化
• WebSocket 支持实时更新
• 认证与授权
• 请求验证与错误处理
• Swagger/OpenAPI 文档
• Docker 支持

项目结构

mcp-protocol-server/
├── app/
│   ├── __init__.py
│   ├── main.py
│   ├── config.py
│   ├── core/
│   │   ├── __init__.py
│   │   ├── context.py
│   │   ├── session.py
│   │   └── protocol.py
│   ├── api/
│   │   ├── __init__.py
│   │   ├── endpoints/
│   │   │   ├── __init__.py
│   │   │   ├── context.py
│   │   │   └── session.py
│   │   └── dependencies.py
│   ├── models/
│   │   ├── __init__.py
│   │   ├── context.py
│   │   └── session.py
│   └── utils/
│       ├── __init__.py
│       └── security.py
├── tests/
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_context.py
│   └── test_session.py
├── docker/
│   ├── Dockerfile
│   └── docker-compose.yml
├── requirements.txt
├── .env.example
└── README.md

安装指南

1. 克隆仓库：

git clone https://github.com/tian1ll1/mcp-protocol-server.git
cd mcp-protocol-server

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # Windows 用户请使用：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 复制示例环境文件并配置设置：

cp .env.example .env

运行服务器

开发模式

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

生产模式

uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 4

使用 Docker

docker-compose up -d

API 文档

服务器运行后，您可以通过以下地址访问 API 文档：

• Swagger UI：http://localhost:8000/docs
• ReDoc：http://localhost:8000/redoc

测试

运行测试套件：

pytest

配置

服务器可通过环境变量或 .env 文件进行配置。请参考 .env.example 了解可用选项。

许可证

该项目采用 MIT License - 具体内容请查看 LICENSE 文件。