Metadata-Version: 2.4
Name: nano-easm-mcp
Version: 0.1.0
Summary: stdio<->HTTPS bridge for the Nano EASM MCP server
Project-URL: Homepage, https://nanoeasm.com
Project-URL: Documentation, https://nanoeasm.com/resources/mcp
Author: Nano EASM
License: MIT
Keywords: easm,mcp,model-context-protocol,nano-easm,security
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# nano-easm-mcp

Stdio <-> HTTPS bridge for the [Nano EASM](https://nanoeasm.com) MCP server.
Lets MCP clients (Claude Desktop, Cursor, VS Code) that speak stdio
connect to the hosted MCP endpoint at `mcp.nanoeasm.com`.

## Install

    pip install nano-easm-mcp

## Configure

1. Sign in at https://nanoeasm.com and go to **Settings -> API Keys -> MCP keys**.
2. Click **Generate Key**, copy the `mcp_sk_...` value (shown only once).
3. Wire your MCP client.

### Claude Desktop

`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or
`%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "nano-easm": {
      "command": "nano-easm-mcp",
      "args": ["--url", "https://mcp.nanoeasm.com",
               "--key", "mcp_sk_..."]
    }
  }
}
```

### Env vars (alternative)

```sh
export NANO_EASM_MCP_URL=https://mcp.nanoeasm.com
export NANO_EASM_MCP_KEY=mcp_sk_...
nano-easm-mcp
```

## What this package is (and isn't)

This package is a transport shim. It contains no business logic. Every
JSON-RPC frame received on stdin is forwarded to the configured hosted
endpoint with `Authorization: Bearer <your-key>`, and the response is
written back to stdout.

If your MCP client supports MCP over HTTP directly, you can point it at
`https://mcp.nanoeasm.com` without this bridge.

## License

MIT.
