Model Context Protocol Server

Model Context Protocol 服务

这是一个基于 FastAPI 的 Model Context Protocol（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  # On 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 文件。