MCPServe

Integrations

  • Allows hosting the MCP server in a Docker container using the provided Docker Compose configuration, making deployment more consistent and portable.

  • Enables connecting to the local MCP server through Ngrok, allowing remote access to the locally hosted server by creating secure tunnels.

  • Includes Shell execution capabilities, enabling the MCP to run shell commands on the host system programmatically.

📖 Table of Contents

🛠️ Setup Local Hosted MCP

## Install uv (if you not using you late to party) curl -LsSf https://astral.sh/uv/install.sh | sh ## Create virtual environemtn uv venv source .venv/bin/activate ## Install Dependencies uv pip install -r requirements.txt ## Start localhost MCPServe python main.py

🛠️ Setup Docker Hosted MCP

docker compose up --build

Client MCP Config

If you have configured auth server side in your code you can enable headers for API. Have found this requires some code changes to the mcp librarie Settings. Adding a middleware prop. :/

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

🚀 Roadmap

  • 🤖 Coming Soon...

Create an issue and lets start a discussion if you'd like to see a feature added to the roadmap.

💡 Issues

Feel free to submit issues and enhancement requests. We're always looking for feedback and suggestions.

🤓 Maintainers

  • Ryan Eggleston - @ryaneggz

📜 License

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

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A simple MCP Server with Shell Execution capabilities that can be connected to locally via Ngrok or hosted in an Ubuntu24 Docker container.

  1. 🛠️ Setup Local Hosted MCP
    1. 🛠️ Setup Docker Hosted MCP
      1. Client MCP Config
        1. 🚀 Roadmap
          1. 💡 Issues
            1. 🤓 Maintainers
              1. 📜 License

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server to run commands.
                  Last updated -
                  2
                  556
                  133
                  TypeScript
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that allows managing Docker containers through natural language, enabling users to compose, introspect, and debug containers without running commands themselves.
                  Last updated -
                  340
                  Python
                  GPL 3.0
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  A simple MCP server that allows accessing and executing shell commands on a VM machine through a web-based terminal interface, with automatic tunneling to make the VM accessible from anywhere.
                  Last updated -
                  39
                  2
                  JavaScript
                • -
                  security
                  A
                  license
                  -
                  quality
                  A simple MCP Server with shell execution capabilities that can be run locally with Ngrok tunneling or hosted in an Ubuntu 24 Docker container.
                  Last updated -
                  3
                  Python
                  MIT License

                View all related MCP servers

                ID: usn7b0vd4h