rocketride-mcp 1.0.7

RocketRide MCP stdio server that streams local files to RocketRide EaaS

Let AI assistants run your RocketRide pipelines via the Model Context Protocol.

Quick Start

pip install rocketride-mcp

Configure your MCP client to use the server (see examples below), then ask your AI assistant to process files through your running RocketRide pipelines.

How It Works

The MCP server connects to a running RocketRide engine and dynamically exposes your pipelines as MCP tools. When an AI assistant calls a tool, the server sends the file to the corresponding pipeline and returns the result.

AI Assistant (Claude, Cursor, ...)
        |
   MCP Protocol
        |
  rocketride-mcp server
        |
   WebSocket (DAP)
        |
  RocketRide Engine
        |
   Your Pipelines

Running pipelines are discovered automatically - start a pipeline in VS Code or via the SDK, and it appears as a callable tool in your AI assistant.

What is RocketRide?

RocketRide is an open-source, developer-native AI pipeline platform. It lets you build, debug, and deploy production AI workflows without leaving your IDE -- using a visual drag-and-drop canvas or code-first with TypeScript and Python SDKs.

• 50+ ready-to-use nodes - 13 LLM providers, 8 vector databases, OCR, NER, PII anonymization, and more
• High-performance C++ engine - production-grade speed and reliability
• Deploy anywhere - locally, on-premises, or self-hosted with Docker
• MIT licensed - fully open-source, OSI-compliant

Installation

pip install rocketride-mcp

Requires Python 3.10+ and rocketride-client-python >= 1.1.0.

Client Configuration

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
	"mcpServers": {
		"rocketride": {
			"command": "rocketride-mcp",
			"env": {
				"ROCKETRIDE_URI": "ws://localhost:5565",
				"ROCKETRIDE_AUTH": "your-api-key"
			}
		}
	}
}

Cursor

Add to .cursor/mcp.json in your workspace:

{
	"mcpServers": {
		"rocketride": {
			"command": "rocketride-mcp",
			"env": {
				"ROCKETRIDE_URI": "ws://localhost:5565",
				"ROCKETRIDE_AUTH": "your-api-key"
			}
		}
	}
}

Claude Code

claude mcp add rocketride -- rocketride-mcp

Set ROCKETRIDE_URI and ROCKETRIDE_AUTH in your environment before running.

Command line

# Using the installed entry point
rocketride-mcp

# Or using Python module
python -m rocketride_mcp

Available Tools

Tools are discovered from the RocketRide server (pipelines/tasks available to your account) plus a built-in convenience tool:

• Server tasks - Any pipelines or tasks returned by the server for your API key are exposed as MCP tools. Each tool accepts a filepath argument and sends that file's contents to the corresponding pipeline.
• RocketRide_Document_Processor - A convenience tool that runs the bundled document-parsing pipeline (simpleparser.json) without requiring a pre-started task. Supports multi-modal parsing (text, images, video, tables, audio).

All tools accept a single filepath parameter (path to the file to process). File paths support:

• Absolute and relative paths
• file:// URIs (automatically decoded)
• ~ home directory expansion

Response format

Tool results include both human-readable text and structured data:

• Text content: Confirmation message plus extracted text from the pipeline result
• Structured content: Raw pipeline result in structuredContent.result for programmatic access

SSE Mode

For remote or Docker deployments, the server can run as an HTTP/SSE server instead of stdio:

pip install rocketride-mcp[sse]
rocketride-mcp-sse --host 0.0.0.0 --port 8080

SSE mode supports optional Bearer token authentication via the MCP_API_KEY environment variable. The /health endpoint is always accessible for monitoring.

Configuration

Set these environment variables (required; no config file is used):

Variable	Required	Description
ROCKETRIDE_URI	Yes	WebSocket URI of the RocketRide engine (e.g. ws://localhost:5565)
ROCKETRIDE_AUTH	Yes*	API authentication token
ROCKETRIDE_APIKEY	Yes*	Alternative to ROCKETRIDE_AUTH
MCP_API_KEY	No	Bearer token for SSE server authentication

*Either ROCKETRIDE_AUTH or ROCKETRIDE_APIKEY must be set.

Links

• Documentation
• GitHub
• Discord
• Contributing

License

MIT - see LICENSE.