@spekoai/mcp
v1.0.8
Published
Local stdio bridge for the hosted SpekoAI MCP server
Readme
@spekoai/mcp
Interactive installer and local stdio-to-remote bridge for Speko MCP. The
installer configures Speko's hosted remote MCP endpoint in coding tools that
support it. The bridge command is only for MCP clients that require a local
stdio command: it speaks stdio to the client, connects to Speko's hosted MCP
server over HTTP, and does not contain Speko tool logic of its own.
Install
npx @spekoai/mcp@latest initThe package exposes the spekoai-mcp binary. Run init for a guided setup
wizard that can configure Claude Code, Codex, OpenCode, Cursor, and generic MCP
clients.
For scripted setup, pass the choices explicitly:
npx @spekoai/mcp@latest init --auth oauth --tools claude,codex --scope user --yesBridge
Most users should run init. Use bridge only when a client cannot connect to
remote MCP directly and asks for a local command-based MCP server.
npx @spekoai/mcp@latest bridgeFor API-key auth in a headless bridge setup, provide SPEKO_API_KEY in the MCP
client environment. The bridge forwards it to the hosted MCP server as
Authorization: Bearer ....
The bridge command adapts local stdio MCP to Speko's remote HTTP MCP endpoint.
Use direct remote MCP configuration instead when your client supports it.
Defaults:
- Endpoint:
https://mcp.speko.ai/mcp
Environment variables:
SPEKO_API_KEY: forward an API key as a bearer token.
CLI examples:
npx @spekoai/mcp@latest bridge
SPEKO_API_KEY=sk_live_xxx npx @spekoai/mcp@latest bridgeAll remaining arguments are passed through to
mcp-remote.
Troubleshooting
Run:
npx @spekoai/mcp@latest bridge --helpWhen using bridge, OAuth state is handled by
mcp-remote. It may create
a local OAuth cache directory, or use MCP_REMOTE_CONFIG_DIR to store local
OAuth credentials and debug logs. The init wizard does not write that
directory.
For connection or OAuth issues, pass --debug and inspect the log path printed
by mcp-remote.
