Model Context Protocol Server

by tian1ll1

347 downloads
Not rated
GitHub

About

A Model Context Protocol server implementation with FastAPI

Details

Author
tian1ll1
Downloads
347
Categories
Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Model Context Protocol Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "model context protocol server": {
            "mcp-protocol-server": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-protocol-server": {
        "command": "python",
        "args": [
            "-m",
            "venv",
            "venv"
        ]
    }
}

Model Context Protocol Server

A FastAPI-based implementation of a Model Context Protocol (MCP) server that handles model context management, session handling, and protocol operations.

Features

- FastAPI-based REST API server
- 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

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

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 # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Copy the example environment file and configure your settings:

cp .env.example .env

Running 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

Once the server is running, you can access the API documentation at:

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

Testing

Run the test suite:

pytest

Configuration

The server can be configured using environment variables or a .env file. See .env.example for available options.

License

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.