scriptproxymcp 0.3.0

Add your description here

Script Proxy MCP

An MCP (Model Context Protocol) server that makes Bash scripts available as MCP tools and exposes skills as MCP resources.

Features

• Automatic Detection: Scans the scripts/ directory for .sh files.

Run the server locally

The server runs over STDIO by default.

uv run src/scriptproxymcp/server.py

Requirements

• Python 3.12+
• mcp package (Model Context Protocol)
• Bash shell

Use it with MCP Inspector

For the MCP Inspector, use the Python/STDIO setup described in the official docs:

• Command: uv [--directory <path-to-project>] run src/scriptproxymcp/server.py

In the Inspector, that maps to the command and arguments fields in the STDIO connection pane.

If you launch the Inspector directly from the project directory, the equivalent command is:

npx @modelcontextprotocol/inspector uv run src/scriptproxymcp/server.py

Two Operation Modes

Development Mode (Local)

{
  "command": "uv",
  "args": ["run", "--directory", "/path/to/project", "scriptproxymcp", "/path/to/scripts"]
}

• Use case: Active development, changes to scripts are picked up immediately
• Requires: uv sync once to set up dependencies
• Note: uv run reads the local pyproject.toml and knows which dependencies to install

Production Mode (PyPI Release)

{
  "command": "uvx",
  "args": ["scriptproxymcp", "/path/to/scripts"]
}

• Use case: Published release, no local checkout needed
• Requires: Package published to PyPI
• Note: uvx downloads and runs the package directly from PyPI