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 文件。