Ross MCP

This repo now contains two related pieces:

• a production-minded ross-mcp monorepo for grounded Ross XPression scripting search, explanation, generation, and validation
• the existing VS Code extension under src/, which can still consume an MCP server for completions

Monorepo layout

apps/mcp-server
packages/shared-types
packages/pattern-library
packages/retriever
packages/ingestors
packages/validator
data/raw
data/processed
data/catalogs
scripts
docs

MCP server scope

The MCP server in apps/mcp-server exposes:

• classify_graphics_domain
• search_ross_scripts
• explain_ross_script
• generate_ross_script
• validate_ross_script
• find_related_patterns

It also exposes resource URIs like:

• ross://docs/xpression/classes/xpSceneDirector
• ross://knowledge/xpression
• ross://patterns/score_update_animation
• ross://community/datalinq_scene_director_examples

Generation is retrieval-gated and always followed by validation. A lightweight domain-classifier tool is included so hosts can route Ross / XPression / OGScript requests into the Ross toolchain before generation. The default MVP runs on a seeded file-backed index in data/processed/chunks/sample-index.json. Production storage is defined for PostgreSQL + pgvector in data/catalogs/postgres-schema.sql.

Build

npm install
npm run compile

Useful commands:

• npm run reindex
• npm run smoke:test
• npm run start:mcp
• npm run package:mcp

Extension note

The legacy VS Code extension code is still present. If you want it to use the new server, point rossMcp.mcpServer.command and rossMcp.mcpServer.args at apps/mcp-server/dist/index.js after building the workspace.

Deployment

The current MCP server is stdio-first, so the supported deployment path is a portable Node bundle rather than a remote HTTP service. Run:

npm run package:mcp

and use the generated release/ross-mcp folder. Details are in deployment.md.