AI导哈

模型上下文协议服务器

一个基于FastAPI的模型上下文协议服务器，用于处理模型上下文管理、会话处理和协议操作。

  • by tian1ll1
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 tian1ll1/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许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP