MCP Protocol Server

🚀 模型上下文协议服务器

本项目是一个基于 FastAPI 实现的模型上下文协议（MCP）服务器，专注于处理模型上下文管理、会话处理以及各类协议操作，为模型的高效运行与管理提供有力支持。

🚀 快速开始

本服务器基于 FastAPI 构建，能有效处理模型上下文管理、会话处理和协议操作。以下为服务器的启动步骤：

安装

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

✨ 主要特性

• 基于 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

📚 详细文档

配置

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

📄 许可证

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