@cequenceai/mcp-stdio

A stdio-to-HTTP bridge for Cequence MCP servers. This package provides a bridge that translates MCP protocol messages from stdio to HTTP requests, enabling AI clients like Claude Desktop to communicate with Cequence MCP servers.

Features

• stdio-to-HTTP Bridge: Translates MCP protocol from stdio to HTTP
• Session Management: Maintains session state across requests
• Authentication Support: Supports API key authentication
• SSE Support: Handles Server-Sent Events format responses
• Error Handling: Proper JSON-RPC error handling

Installation

npm install -g @cequenceai/mcp-stdio

Usage

Basic Usage

cequence-mcp-stdio start --url https://your-mcp-server.com/mcp

With API Key Authentication

cequence-mcp-stdio start --url https://your-mcp-server.com/mcp --api-key your-api-key

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "your-server": {
      "command": "npx",
      "args": ["-y", "@cequenceai/mcp-stdio", "start", "--url", "https://your-mcp-server.com/mcp"],
      "env": {
        "npm_config_yes": "true"
      }
    }
  }
}

With Authentication

{
  "mcpServers": {
    "your-server": {
      "command": "npx",
      "args": ["-y", "@cequenceai/mcp-stdio", "start", "--url", "https://your-mcp-server.com/mcp", "--api-key", "your-api-key"],
      "env": {
        "npm_config_yes": "true"
      }
    }
  }
}

How It Works

1. Listens on stdio for MCP protocol messages from AI clients
2. Establishes sessions with the HTTP MCP server
3. Translates requests from JSON-RPC to HTTP POST requests
4. Handles responses including Server-Sent Events format
5. Maintains session state across multiple requests
6. Returns responses in proper JSON-RPC format

Requirements

• Node.js 16.0.0 or higher
• Access to a Cequence MCP server endpoint

License

MIT

Support

For issues and questions, please visit: https://github.com/cequence-io/mcp-api-gateway/issues