MCP Protocol Server

🚀 Model Context Protocol Server

A Model Context Protocol (MCP) server implemented with FastAPI, responsible for model context management, session handling, and protocol operations.

🚀 Quick Start

This is a Model Context Protocol (MCP) server implemented using FastAPI, which handles model context management, session processing, and protocol operations.

✨ Features

• REST API server based on FastAPI
• Model context management
• Session handling and persistence
• WebSocket support for real-time updates
• Authentication and authorization
• Request validation and error handling
• Swagger/OpenAPI documentation
• Docker support

📦 Installation

1. Clone the repository:

git clone https://github.com/tian1ll1/mcp-protocol-server.git
cd mcp-protocol-server

2. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # For Windows users, use: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Copy the example environment file and configure settings:

cp .env.example .env

💻 Usage Examples

Run the server

Development mode

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Production mode

uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 4

Using Docker

docker-compose up -d

API Documentation

After the server is running, you can access the API documentation at the following addresses:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Testing

Run the test suite:

pytest

📚 Documentation

The server can be configured via environment variables or the .env file. Refer to .env.example for available options.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Project Structure

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