Metadata-Version: 2.4
Name: yaozh-mcp-stdio
Version: 0.1.0
Summary: Local stdio MCP proxy for the remote Drug MCP streamable-http service.
Project-URL: Homepage, https://example.invalid/yaozh-mcp-stdio
Author: Drug MCP Team
License: Proprietary
Keywords: mcp,proxy,stdio,streamable-http
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.9.0
Description-Content-Type: text/markdown

# 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.

```text
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:

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

Recommended usage with environment variables:

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

Windows PowerShell:

```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:

```json
{
  "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:

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

## Options

```bash
yaozh-mcp-stdio --help
```

```text
--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:

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

Build package:

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

Publish to TestPyPI:

```bash
twine upload --repository testpypi dist/*
```

Publish to PyPI:

```bash
twine upload dist/*
```
