Yaozh MCP Stdio Proxy

Local stdio MCP proxy for the remote Drug MCP streamable-http service.

It is intended for MCP clients that only support stdio. The proxy runs locally and forwards MCP tool calls to the remote HTTP MCP endpoint.

MCP client
  -> local stdio proxy
  -> remote streamable-http MCP service

The proxy does not store API keys or results. Authentication, permissions, quota and audit logs are still handled by the remote MCP service.

Install And Run With uvx

After publishing this package to PyPI:

uvx yaozh-mcp-stdio --url http://<server-ip>/mcp --api-key <token>

Recommended usage with environment variables:

MCP_HTTP_URL="http://<server-ip>/mcp" \
MCP_API_KEY="<token>" \
uvx yaozh-mcp-stdio

Windows PowerShell:

$env:MCP_HTTP_URL="http://<server-ip>/mcp"
$env:MCP_API_KEY="<token>"
uvx yaozh-mcp-stdio

MCP Client Config

Pass token by environment variables:

{
  "mcpServers": {
    "drug-mcp": {
      "command": "uvx",
      "args": [
        "yaozh-mcp-stdio"
      ],
      "env": {
        "MCP_HTTP_URL": "http://<server-ip>/mcp",
        "MCP_API_KEY": "<token>"
      }
    }
  }
}

Or pass token by arguments:

{
  "mcpServers": {
    "drug-mcp": {
      "command": "uvx",
      "args": [
        "yaozh-mcp-stdio",
        "--url",
        "http://<server-ip>/mcp",
        "--api-key",
        "<token>"
      ]
    }
  }
}

Options

yaozh-mcp-stdio --help

--url       Remote streamable-http MCP URL. Default reads MCP_HTTP_URL.
--api-key   Bearer token. Default reads MCP_API_KEY.
--timeout   Remote request timeout in seconds. Default reads MCP_PROXY_TIMEOUT or 120.

Local Development

Install editable:

pip install -e .
yaozh-mcp-stdio --url http://127.0.0.1/mcp --api-key <token>

Build package:

python -m pip install --upgrade build twine
python -m build
twine check dist/*

Publish to TestPyPI:

twine upload --repository testpypi dist/*

Publish to PyPI:

twine upload dist/*