MCP Protocol Server

模型上下文协议服务器

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

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

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖项：

pip install -r requirements.txt

1. 复制示例环境文件并配置您的设置：

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用户界面：http://localhost:8000/docs
• ReDoc ：http://localhost:8000/redoc

测试

运行测试套件：

pytest

配置

服务器可以使用环境变量或 .env 文件。看 .env.example 查看可用选项。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。