MCP Sse

🚀 MCPServe - Developed by @ryaneggz

A simple MCP server with shell execution capabilities. Connect to the local environment via Ngrok or host an Ubuntu 24 container in Docker.

🚀 Quick Start

📦 Installation

There are two ways to host MCP: locally or in Docker.

Host MCP Locally

## Install uv (If you're not using it, you're missing out!)
curl -LsSf https://astral.sh/uv/install.sh | sh

## Create a virtual environment
uv venv
source .venv/bin/activate

## Install dependencies
uv pip install -r requirements.txt

## Start the local MCP service
python main.py

Host MCP in Docker

docker compose up --build

Client MCP Configuration

If you enable server - side authentication in your code, you can enable the API headers. This may require some code modifications to the MCP library, such as adding middleware attributes.

{
  "terminal": {
    "transport": "sse",
    "url": "http://localhost:8005/sse",
    // "headers": {
    //     "x-api-key": "abcdef123456..."
    // }
  }
}

📚 Documentation

• Deployment

🚀 Roadmap

• [ ] 🤖 Coming soon...

If you'd like to see a certain feature on the roadmap, please submit an issue and start a discussion.

💡 Issues

Feel free to submit issues and improvement requests. We always welcome feedback and suggestions.

🤓 Maintainers

• Ryan Eggleston - @ryaneggz

📄 License

This project is open - source and licensed under the MIT License. Feel free to use, modify, and distribute the code.