MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨

What is MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨?

MCPServe is a lightweight MCP server framework designed to simplify Shell command execution and remote server access. It enables developers to run a local MCP server with Ngrok tunneling for external access or deploy via Docker containers on Ubuntu 24. Key components include integration with uv tooling for dependency management and flexible transport configurations for client communication.

How to use MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨?

Local Deployment Setup

# Install uv dependency manager
curl -LsSf https://astral.sh/uv/install.sh | sh

# Initialize virtual environment
uv venv
source .venv/bin/activate

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

# Launch MCP server instance
python main.py

Docker Deployment Setup

docker compose up --build

Key Features of MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨?

• Ngrok Integration: Exposes local server endpoints through secure tunnels for remote access
• Docker Native Support: Full containerization using Ubuntu 24 base image with compose orchestration
• Flexible Transport: SSE-based terminal transport with configurable headers for API authentication
• uv Toolchain: Streamlined dependency management through Astral's uv tool
• Middleware Extensibility: Supports custom authentication layers through header injection

Use cases of MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨?

• Local development environments with remote debugging capabilities
• Team collaboration through temporary Ngrok exposed endpoints
• Cloud deployment using Docker containers for production workloads
• API prototyping with quick-start server configurations
• Education demonstrations showing API-Shell integration patterns

FAQ from MCPServe by @ryaneggz: Shell Access & Ngrok Magic ✨?

Why use uv instead of pip?

uv provides faster package installation and dependency resolution optimizations for development workflows

Can I customize authentication?

Yes - requires adding header configurations in client settings and middleware adjustments in server code

Does Ngrok require configuration?

Automatic tunneling is handled by the server - no additional setup required beyond local execution

What transport protocols are supported?

Currently supports Server-Sent Events (SSE) for terminal communication with HTTP API endpoints

🤖 MCPServe by @ryaneggz

Simple MCP Server w/ Shell Exec. Connect to Local via Ngrok, or Host Ubuntu24 Container in Docke

📖 Table of Contents

• Deploy

🛠️ 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.