ryaneggz_mcpserve
by ryaneggzMCPServe with Shell Execution and Docker Integration
Overview
MCPServe is a simple MCP server that supports shell execution. It allows you to connect to a local server via Ngrok or host an Ubuntu 24 container via Docker. This project is designed to provide a flexible and easy-to-use solution for managing MCP servers with shell capabilities.
Features
- Shell Execution: Execute shell commands directly from the MCP server.
- Local Hosting: Connect to a local server using Ngrok.
- Docker Integration: Host the server in an Ubuntu 24 container using Docker.
- Customizable Configuration: Easily configure the server to meet your needs.
Setup
Local Hosting
To set up MCPServe locally, follow these steps:
## Install uv (if you not using you late to party)
curl -LsSf https://astral.sh/uv/install.sh | sh
## Create virtual environment
uv venv
source .venv/bin/activate
## Install Dependencies
uv pip install -r requirements.txt
## Start localhost MCPServe
python main.py
Docker Hosting
To set up MCPServe using Docker, run the following command:
docker compose up --build
Configuration
You can configure the MCP client by modifying the settings as shown below:
{
"terminal": {
"transport": "sse",
"url": "http://localhost:8005/sse",
// "headers": {
// "x-api-key": "abcdef123456..."
// }
}
}
Roadmap
- Coming Soon: New features and enhancements are in the pipeline. Feel free to create an issue to discuss potential additions.
Issues
If you encounter any issues or have suggestions for improvements, please submit them here.
Maintainers
- Ryan Eggleston - @ryaneggz
License
This project is open-source and available under the MIT License.
About
MCPServe is a project designed to simplify the process of managing MCP servers with shell execution capabilities. It supports local hosting via Ngrok and Docker integration for hosting in an Ubuntu 24 container.
Invite Gmail Contacts
