Shell MCP Server

## Shell MCP Server Simple Model Context Protocol (MCP) server that exposes a single `terminal` tool for running shell commands. ### Prerequisites - Python 3.11+ - [uv](https://github.com/astral-sh/uv) or `pip` ### Installation ```bash uv sync # or pip install -e . ``` ### Usage Run the server over stdio: ```bash python main.py ``` The server registers a `terminal` tool. Invoke it with an object shaped like: ```json { "command": "echo hello" } ``` Command output is returned as MCP `TextContent`. Errors are surfaced with a prefixed `Error:` message. ### Resource This server exposes a resource: - ID: `mcpreadme://desktop` - Returns the contents of `mcpreadme.md` resolved from OneDrive Desktop. Resolution order: - `$OneDrive/Desktop/mcpreadme.md` - `~/OneDrive/Desktop/mcpreadme.md` - `~/Desktop/mcpreadme.md` If the file is missing or unreadable, a textual error message is returned. ### Docker Build and run with uv inside the container (per uv Docker guide): ```bash docker build -t shellserver . docker run --rm -it shellserver ``` This image installs `uv` from the official image and uses: - Dependency caching layers via `uv sync --no-install-project` - Final run command equivalent to local: `uv run main.py` Reference: uv Docker integration docs: [Installing a project](https://docs.astral.sh/uv/guides/integration/docker/#installing-a-project)