scorpiox-mcp MCP

Native MCP (Model Context Protocol) client implementing JSON-RPC 2.0 over stdio. Connects AI agents to external tool servers using the open MCP standard, enabling seamless tool discovery, invocation, and session management.

Linux x64 Linux ARM64 macOS ARM64 Windows x64

⚙️ Flags & Options

Flag	Short	Description	Takes Value
`--verbose`	`-v`	Set verbosity level (0=silent, 1=normal, 2=debug)	Yes
`--help`	`-h`	Show help message and exit	No
`--json`		Output results in JSON format for scripting	No
`--config`		Path to MCP configuration file	Yes
`--mcp-file`		Path to .mcp.json tool definition file	Yes

📖 Usage Examples

Basic — show help

scorpiox-mcp --help

Launch an MCP server and list available tools

# Start an MCP tool server process and discover its capabilities scorpiox-mcp --mcp-file ./my-tools/.mcp.json

Use a custom configuration file

# Point to a project-specific MCP config scorpiox-mcp --config /path/to/mcp-config.json

JSON output for scripting and automation

# Get structured JSON output suitable for piping scorpiox-mcp --json --mcp-file .mcp.json

Debug mode — verbose output

# Run with debug-level verbosity to diagnose issues scorpiox-mcp -v 2 --mcp-file .mcp.json

Integrate with scorpiox-code agent sessions

# scorpiox-mcp is used internally by scorpiox-code to connect # AI agents to MCP tool servers via JSON-RPC 2.0 over stdio. # The .mcp.json file defines which tool servers to launch: cat .mcp.json # { # "mcpServers": { # "filesystem": { # "command": "npx", # "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home"] # } # } # } scorpiox-mcp --mcp-file .mcp.json --json

Combine with other scorpiox tools

# Pipe MCP tool list to jq for filtering scorpiox-mcp --json --mcp-file .mcp.json | jq '.tools[] | .name' # Use with verbose to trace JSON-RPC messages scorpiox-mcp -v 2 --config project-mcp.json 2>mcp-debug.log

🔧 Source & Build Info

Source File

scorpiox/scorpiox-mcp.c

Lines of Code

1,766

Dependencies

libsxutil

scorpiox-mcp MCP

⚙️ Flags & Options

📖 Usage Examples

🔧 Source & Build Info

🔗 Related Tools