mcp-server-openrouter-multimodal

Python uvx / pip launcher for the Node.js MCP server @stabgan/openrouter-mcp-multimodal.

This package does not reimplement the server — it execs npx -y @stabgan/openrouter-mcp-multimodal so Python-first workflows can use the same uvx pattern as native Python MCP servers. Node.js 20+ (with npx on PATH) is required.

Run

export OPENROUTER_API_KEY=sk-or-v1-...
uvx mcp-server-openrouter-multimodal

Pin the npm release:

export OPENROUTER_MCP_NPM_VERSION=4.8.0
uvx mcp-server-openrouter-multimodal

Optional env vars:

• OPENROUTER_MCP_NPM_VERSION — pin the underlying npm package version
• OPENROUTER_MCP_NPM_SPEC — path to a local .tgz from npm pack (dev/testing)

stdio / first-run note

The launcher execs npx, which downloads the npm package on first run. npm install progress goes to stderr, not stdout; the MCP JSON-RPC stream uses the child process stdout. In testing, a cold-cache npx -y @stabgan/openrouter-mcp-multimodal produced zero stdout bytes before the server started. If your client misroutes stderr into the protocol stream, set NPM_CONFIG_LOGLEVEL=silent in the MCP server env block.

MCP client config

{
  "mcpServers": {
    "openrouter": {
      "command": "uvx",
      "args": ["mcp-server-openrouter-multimodal"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-..."
      }
    }
  }
}

pipx equivalent: pipx run mcp-server-openrouter-multimodal