Shell Executor
Integrates with
Shell, Ngrok, Docker
π 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.