@tsi-forge/mcp-server

An MCP server that turns a natural-language description into a valid Traktor .tsi controller mapping — without ever calling an LLM itself.

The server exposes deterministic primitives over stdio; your MCP host (Claude Desktop, Claude Code, …) does the reasoning. v1 targets the Allen & Heath Xone:K3 on Traktor Pro 3.

Part of tsi-forge.

Install

Claude Code:

claude mcp add tsi-forge -- npx -y @tsi-forge/mcp-server

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "tsi-forge": { "command": "npx", "args": ["-y", "@tsi-forge/mcp-server"] }
  }
}

Runs on a plain Node install (≥ 18); no Bun required at runtime.

Use

Ask your assistant in plain language, e.g.:

"Make me a Xone:K3 mapping with 4 decks on layer 1 and 4 FX units on layer 2, then give me the .tsi."

It orchestrates the tools below and returns the file contents — save them with a .tsi extension and import via Traktor → Preferences → Controller Manager → Import.

Tools

| Tool | Purpose | |---|---| | list_controller_layout | Physical surface + factory MIDI map, per layer. | | list_traktor_actions | Catalog of mappable Traktor actions (filterable). | | generate_mapping_template | MappingJSON skeleton, one entry per control on a layer. | | validate_mapping | Schema + semantic checks → { ok, issues }. | | encode_mapping | MappingJSON → importable .tsi (validates first). | | decode_tsi | .tsi → MappingJSON. |

How it stays free & deterministic

The server ships no model and makes no API calls — all reasoning is the host LLM's. Same input, same bytes out. The mapping logic lives in @tsi-forge/core; this package is a thin tool wrapper.

License

MIT.