🤖 MCPServe by @ryaneggz
About
🤖 MCPServe by @ryaneggz is a simple MCP (Model Context Protocol) server with shell execution capabilities. It can be hosted locally, connected to via Ngrok, or deployed as a Docker container running Ubuntu 24. It is designed for developers who need an MCP server that can execute…
Details
- Author
- ryaneggz
- GitHub stars
- 4
- Downloads
- 466
- Categories
- Other, Cloud Service
Jump to
- Simple MCP server with shell execution
- Local hosting via Python or Docker
- Ngrok support for remote access
- SSE (Server-Sent Events) transport
- Optional API key authentication header
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🤖 MCPServe by @ryaneggzCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install uv, create a virtual environment, install dependencies from requirements.txt, and start the server with python main.py. For Docker, run docker compose up --build. Configure your MCP client with the SSE transport URL http://localhost:8005/sse and optionally add an x-api-key header if server-side authentication is enabled.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udd16 mcpserve by @ryaneggz": {
"mcpserve": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"mcpserve": {
"command": "uv",
"args": [
"venv"
]
}
}<h1 align="center">
🤖 MCPServe by @ryaneggz
</h1>
<p align="center">
Simple MCP Server w/ Shell Exec. Connect to Local via Ngrok, or Host Ubuntu24 Container in Docke
</p>
<p align="center">
<a href="#">
<a href="https://join.slack.com/t/promptengineersai/shared_invite/zt-21upjsftv-gX~gNjTCU~2HfbeM_ZwTEQ">
</p>
<p align="center">
</p>
📖 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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
