sxmc

One Rust binary. Skills become MCP servers. MCP servers become CLI commands. Any API becomes a CLI.

What is sxmc?

MCP (Model Context Protocol) is an open standard for connecting AI assistants to external tools and data sources. Today, if you have skills (structured AI instructions), MCP servers, and APIs, each one requires its own adapter, its own client setup, and its own CLI wrapper. There is no single tool that bridges all three.

sxmc solves this. One Rust binary that:

Turns skill directories into MCP servers (stdio or remote HTTP)
Makes MCP tools, prompts, and resources usable from the command line
Auto-generates CLI commands from OpenAPI and GraphQL specs
Scans skills and MCP servers for security threats

Skills  -->  MCP Server     (serve skills to any MCP client)
MCP Server  -->  CLI        (list MCP surfaces, invoke MCP tools)
Any API  -->  CLI           (OpenAPI & GraphQL auto-detection)

What is sxmc?
Prerequisites
Install
Quick Start
Skills
Security Scanning
Architecture
Client Compatibility
CLI Reference
Development
Acknowledgements
License

Prerequisites

Rust toolchain (stable) — install via rustup.rs (required for cargo install)
Node.js (optional) — only needed if using the npm wrapper
No runtime dependencies — sxmc compiles to a single static binary

Install

Install from crates.io:

cargo install sxmc

Other channels:

GitHub Releases: prebuilt archives plus .sha256 files
npm wrapper metadata aligned to 0.1.7: packaging/npm The wrapper downloads and verifies release binaries during postinstall.
Homebrew formula pinned to the current release tag: packaging/homebrew/sxmc.rb Tap guidance: packaging/homebrew/README.md

Or build from source:

git clone https://github.com/aihxp/sxmc.git
cd sxmc
cargo build --release
# Binary at target/release/sxmc

Additional setup and client-specific configuration examples are in docs/CLIENTS.md. The maintained compatibility ledger is in docs/COMPATIBILITY_MATRIX.md, hosted deployment guidance is in docs/DEPLOYMENT.md, and connection examples are in docs/CONNECTION_EXAMPLES.md. Release and publishing steps are in docs/RELEASING.md. Distribution-channel notes are in docs/DISTRIBUTION.md, smoke checks are in docs/SMOKE_TESTS.md, performance and token notes are in docs/VALUE_AND_BENCHMARK_FINDINGS.md, the explicit support contract is in docs/PRODUCT_CONTRACT.md, and launch copy is in docs/LAUNCH.md.

Package-specific notes:

npm wrapper docs: packaging/npm/README.md
Homebrew tap docs: packaging/homebrew/README.md

Quick Start

Serve skills as an MCP server

# stdio (for MCP client configs)
sxmc serve

# Streamable HTTP MCP endpoint at http://127.0.0.1:8000/mcp
sxmc serve --transport http --host 127.0.0.1 --port 8000

# Development mode: reload skills when SKILL.md, scripts/, or references/ change
sxmc serve --watch

# Require auth headers for remote MCP access
sxmc serve --transport http --host 0.0.0.0 --port 8000 \
  --require-header "Authorization: env:SXMC_MCP_TOKEN"

# Or use Bearer token auth plus a health endpoint
sxmc serve --transport http --host 0.0.0.0 --port 8000 \
  --bearer-token env:SXMC_MCP_TOKEN
curl http://127.0.0.1:8000/healthz
sxmc http http://127.0.0.1:8000/mcp \
  --auth-header "Authorization: Bearer $SXMC_MCP_TOKEN" --list

Add to any MCP client config:

{ "mcpServers": { "skills": { "command": "sxmc", "args": ["serve"] } } }

Run a skill directly

sxmc skills list
sxmc skills run pr-review 42

Example output of sxmc skills list:

simple-skill
  A simple test skill

skill-with-references
  A skill with reference documents
  Resources: style-guide.md

skill-with-scripts
  A skill with executable scripts
  Tools: hello.sh

When served over MCP, each skill is exposed in a hybrid form:

the skill body as an MCP prompt
scripts/ as MCP tools
references/ as MCP resources
generic retrieval tools for listing skills, reading skill details, and reading files

This lets sxmc work well with local stdio-based MCP clients such as Codex, Cursor, Gemini CLI, and similar coding agents. It can also be hosted as a remote streamable HTTP MCP server for clients that consume HTTP MCP endpoints. The dated validation status for those clients lives in docs/COMPATIBILITY_MATRIX.md.

Any MCP server as CLI

# stdio server
sxmc stdio "npx @mcp/github" --list
sxmc stdio "npx @mcp/github" search-repos query=rust
sxmc stdio "npx @mcp/github" --prompt triage-template
sxmc stdio "npx @mcp/github" --resource "repo://octocat/hello-world/README.md"

# HTTP server
sxmc http https://mcp.example.com/mcp --list
sxmc http https://mcp.example.com/mcp my-tool key=value
sxmc http https://mcp.example.com/mcp --prompt triage-template
sxmc http https://mcp.example.com/mcp --resource "repo://octocat/hello-world/README.md"

sxmc stdio and sxmc http are MCP bridges that can:

list tools, prompts, and resources
list one surface at a time with --list-tools, --list-prompts, or --list-resources
invoke tools
fetch prompts with --prompt
read resources with --resource
describe the negotiated server surface with --describe
show one tool’s schema/help with --describe-tool NAME

This makes them especially useful for shell automation, CI, debugging, and inspecting an MCP server outside an IDE or agent UI. When a server is tool-only and does not implement prompts/resources, generic --list now stays successful and skips unsupported surfaces instead of failing the whole command.

That means skills can flow through both stages in one go:

# Serve local skills over MCP, then bridge that MCP server back into CLI
sxmc stdio "sxmc serve --paths tests/fixtures" --list
sxmc stdio "sxmc serve --paths tests/fixtures" --list-tools
sxmc stdio "sxmc serve --paths tests/fixtures" get_available_skills --pretty
sxmc stdio "sxmc serve --paths tests/fixtures" --describe --pretty
sxmc stdio "sxmc serve --paths tests/fixtures" --describe-tool get_skill_details
sxmc stdio "sxmc serve --paths tests/fixtures" get_skill_details name=simple-skill --pretty
sxmc stdio "sxmc serve --paths tests/fixtures" --prompt simple-skill arguments=friend
sxmc stdio "sxmc serve --paths tests/fixtures" --resource \
  "skill://skill-with-references/references/style-guide.md"
sxmc stdio "sxmc serve --paths tests/fixtures" get_skill_related_file \
  skill_name=skill-with-references \
  relative_path=references/style-guide.md

Hosted MCP servers work the same way over HTTP:

sxmc http http://127.0.0.1:8000/mcp \
  --auth-header "Authorization: Bearer $SXMC_MCP_TOKEN" \
  --list

For a captured end-to-end sample of this exact `skills -> MCP -> CLI` path, see
[`docs/SKILLS_TO_MCP_TO_CLI_SAMPLES.md`](docs/SKILLS_TO_MCP_TO_CLI_SAMPLES.md).
sxmc http http://127.0.0.1:8000/mcp \
  --auth-header "Authorization: Bearer $SXMC_MCP_TOKEN" \
  --describe --pretty
sxmc http http://127.0.0.1:8000/mcp \
  --auth-header "Authorization: Bearer $SXMC_MCP_TOKEN" \
  --prompt simple-skill arguments=friend

For hosted /mcp endpoints, prefer --require-header so remote access is not left open by default. For single-token hosted deployments, --bearer-token is usually the friendlier option. Hosted deployment guidance, reverse-proxy notes, and operational checks are in docs/DEPLOYMENT.md.

For sxmc stdio, you can now pass either shell-style quoting or a JSON-array command spec such as ["sxmc","serve","--paths","tests/fixtures"]. For nested or project-local servers, --cwd gives you an explicit working directory when you do not want to rely on the caller’s current directory. For local skill development, sxmc serve --watch polls skill files once per second and reloads the in-memory server when it detects a change.

Any API as CLI

# Auto-detect (OpenAPI or GraphQL)
sxmc api https://petstore3.swagger.io/api/v3/openapi.json --list
sxmc api https://petstore3.swagger.io/api/v3/openapi.json findPetsByStatus status=available
sxmc api https://petstore3.swagger.io/api/v3/openapi.json findPetsByStatus status=available --format toon

# Explicit modes
sxmc spec ./openapi.yaml listPets limit=10
sxmc graphql https://api.example.com/graphql users limit=5

Protected endpoints can use --auth-header, and header values support env:VAR_NAME and file:/path/to/secret forms for secret resolution. For public OpenAPI smoke tests, findPetsByStatus on the Petstore v3 endpoint is a more stable example than getInventory. For structured API responses, --format json|json-pretty|toon lets you choose between compact JSON, pretty JSON, or a Rust-native TOON-style rendering that compresses repeated keys in tabular data. --pretty remains a shorthand for pretty JSON.

Security scanning

sxmc scan                                     # scan all skills
sxmc scan --skill my-skill                    # scan one skill
sxmc scan --severity critical                 # filter by severity
sxmc scan --json                              # JSON output

Example output:

[SCAN] skill:malicious-skill — 7 issue(s) found
  [CRITICAL] SL-INJ-001 (Prompt injection detected): Line contains prompt injection pattern
  [CRITICAL] SL-SEC-001 (Potential secret exposed): Line may contain a hardcoded secret
  [ERROR]    SL-HIDE-001 (Hidden Unicode characters): Found 1 'zero-width space' character(s)
  [ERROR]    SL-EXEC-001 (Dangerous script operation): Line contains potentially dangerous operation
  [WARN]     SL-PERM-001 (Wildcard tool permission): Skill requests wildcard tool access '*'
[PASS] skill:simple-skill — no issues at severity >= info
[PASS] skill:other-skill — no issues at severity >= info

Bake and reuse connections

sxmc bake create pets --type spec --source https://petstore.swagger.io/v3/openapi.json
sxmc bake list
sxmc bake show pets

Generate skills from APIs

sxmc skills create https://api.example.com/openapi.json
# Creates a SKILL.md with all operations documented

Skills

Skills are directories containing a SKILL.md file with YAML frontmatter and a markdown body. They can optionally include scripts/ (executable tools) and references/ (context resources).

my-skill/
  SKILL.md          # Required: frontmatter + instructions
  scripts/           # Optional: become MCP tools
    deploy.sh
  references/        # Optional: become MCP resources
    style-guide.md

SKILL.md format

---
name: my-skill
description: "What this skill does"
argument-hint: "<repo> [--dry-run]"
allowed-tools:
  - Bash
  - Read
---

Instructions for the AI when this skill is invoked.

Use $ARGUMENTS for user-provided arguments.

Skill discovery

Skills are discovered from (in priority order):

--paths flag (explicit)
.claude/skills/ (project-local)
~/.claude/skills/ (user-global)

Security Scanning

sxmc includes a native Rust security scanner that analyzes skills and MCP servers for threats. Scans are available through the scan command for skills and MCP servers.

What it detects

Skill scanning:

Prompt injection patterns (ignore instructions, role switching, jailbreak attempts)
Hidden Unicode characters (zero-width spaces, RTL overrides, homoglyphs)
Hardcoded secrets (AWS keys, GitHub tokens, API keys, passwords)
Dangerous script operations (rm -rf, chmod 777, eval, curl|bash)
Data exfiltration patterns (webhook posts, DNS exfil)
Overly broad tool permissions (wildcard *, dangerous tool names)

MCP server scanning:

Tool shadowing (servers overriding trusted tools)
Prompt injection in tool descriptions
Excessive permission requests
Overly permissive input schemas

Severity levels

Level	Meaning
`info`	Informational, no action needed
`warning`	Potential issue, review recommended
`error`	Likely security problem
`critical`	Definite threat, blocks execution

Architecture

sxmc
├── Security Layer
│   ├── Skill Scanner — prompt injection, secrets, hidden chars
│   └── MCP Scanner  — tool shadowing, response injection
├── Scan Command
│   └── Explicit security analysis for skills and MCP servers
├── Server Side
│   └── Discovery → Parser → MCP Server (rmcp)
└── Client Side
    ├── MCP Client — stdio & HTTP transports
    ├── OpenAPI    — spec parsing + HTTP execution
    ├── GraphQL    — introspection + query building
    ├── Bake       — saved connection configs
    └── Cache      — file-based with TTL

Built on rmcp (official Rust MCP SDK).

Client Compatibility

sxmc currently targets local stdio MCP clients first, and also supports a remote streamable HTTP MCP endpoint at /mcp.

Supported now: Codex, Cursor, Gemini CLI, Claude Code-style local MCP clients
Supported now for remote MCP consumers too: streamable HTTP MCP at /mcp
Recommended for hosted remote MCP: --bearer-token env:SXMC_MCP_TOKEN
Health endpoint for hosted deployments: /healthz
Local development convenience: sxmc serve --watch

See docs/CLIENTS.md for client-specific setup examples, the current compatibility matrix, and repeatable smoke-check commands.

CLI Reference

sxmc [subcommand] [options]

SERVER:
  serve [--paths ...] [--watch] [--transport stdio|http|sse] [--host 127.0.0.1] [--port 8000] [--require-header K:V] [--bearer-token TOKEN]

SKILLS:
  skills list [--paths ...] [--json]
  skills info <name> [--paths ...]
  skills run <name> [args...] [--paths ...]
  skills create <api-url> [--output-dir DIR] [--auth-header K:V]

CLIENT:
  stdio <command> [tool] [args...] [--prompt NAME] [--resource URI] [--list] [--list-tools] [--list-prompts] [--list-resources] [--describe] [--describe-tool NAME] [--search] [--pretty] [--env K=V] [--cwd DIR]
  http <url> [tool] [args...] [--prompt NAME] [--resource URI] [--list] [--list-tools] [--list-prompts] [--list-resources] [--describe] [--describe-tool NAME] [--search] [--pretty] [--auth-header K:V]
  api <source> [operation] [args...] [--list] [--pretty] [--format json|json-pretty|toon] [--auth-header K:V]
  spec <source> [operation] [args...] [--list] [--pretty] [--format json|json-pretty|toon] [--auth-header K:V]
  graphql <url> [operation] [args...] [--list] [--pretty] [--format json|json-pretty|toon] [--auth-header K:V]

SECURITY:
  scan [--paths ...] [--skill <name>] [--severity warn|error|critical] [--json]

BAKE:
  bake create <name> --type <stdio|http|api|spec|graphql> --source <src> [--description ...]
  bake list
  bake show <name>
  bake update <name> [--type ...] [--source ...] [--description ...]
  bake remove <name>

Hybrid skill retrieval tools exposed by serve:

get_available_skills
get_skill_details
get_skill_related_file

Development

# Run tests
cargo test

# Build
cargo build --release

# Run directly
cargo run -- skills list --paths tests/fixtures
cargo run -- scan --paths tests/fixtures
bash scripts/smoke_test_clients.sh target/debug/sxmc tests/fixtures

Acknowledgements

sxmc was inspired by and builds upon ideas from:

mcp2cli — the Python MCP-to-CLI bridge that sxmc reimplements in Rust with skills as a first-class concept
skill-to-mcp — an early skills-to-MCP adapter that helped validate the value of exposing skill collections through MCP
toon-format/toon — format and benchmark work that informed sxmc's TOON-style structured API output
claude-skill-antivirus — skill security scanning patterns
skillfile — declarative skill manifest concepts
Mcpwn — MCP server security analysis techniques
rmcp — the official Rust MCP SDK powering the protocol layer

License

MIT

sxmc 0.1.7