Create with Cavalry from AI. An MCP server that gives your AI assistant a direct line into Cavalry — run scripts, query the knowledge base, and animate from a prompt.
Overview
- — Claude executes Cavalry JavaScript live via the Stallion bridge - — searches 40,000+ chunks of Cavalry documentation, real scenes, and community knowledge semantically - — reads and saves your active scene - — auto-loads a verified best-practices reference on every session Download lancedb_public.zip from GitHub Releases, extract into the project: LanceDB requires a local drive. Set an absolute local path: LANCEDB_PATH=C:/Users/yourname/.cavalry-assistant/lancedb_public Scripts > Stallion — leave it running on port 8080. The .mcp.json in this folder auto-registers when opened in Claude Code. Or manually: The public knowledge base include Discord community data (private). - Stallion always responds "Success" — check Cavalry's console panel for actual errors - Always start scene-modifying scripts with api.stop() - Full API reference: prompts/cavalry-best-practices.
README
What it does
- Write & run scripts — Claude executes Cavalry JavaScript live via the Stallion bridge
- Knows the docs — searches 40,000+ chunks of Cavalry documentation, real scenes, and community knowledge semantically
- Scene-aware — reads and saves your active scene
- Stays current — auto-loads a verified best-practices reference on every session
Requirements
| Tool | Purpose |
|---|---|
| Cavalry | The app — needs Stallion enabled |
| Node.js 18+ | Runs the MCP server |
| Ollama | Local embeddings |
| Claude Code | The AI client |
Quick Setup (pre-built knowledge base)
1. Clone and install
git clone cavalry-assistant
cd cavalry-assistant
cp .env.example .env
npm install --prefix mcp
npm run build --prefix mcp
2. Download the knowledge base
Download lancedb_public.zip from GitHub Releases, extract into the project:
cavalry-assistant/
data/
lancedb_public/ ← extract here
Update .env:
LANCEDB_PATH=./data/lancedb_public
Windows / network drive users: LanceDB requires a local drive. Set an absolute local path:
LANCEDB_PATH=C:/Users/yourname/.cavalry-assistant/lancedb_public
3. Start Ollama
ollama pull nomic-embed-text
4. Enable Stallion in Cavalry
Scripts > Stallion — leave it running on port 8080.
5. Connect to Claude Code
The .mcp.json in this folder auto-registers when opened in Claude Code. Or manually:
claude mcp add cavalry-assistant node mcp/dist/index.js
6. Start a session
/cavalry
Knowledge Base
| Source | Content |
|---|---|
| Official docs | Full Cavalry documentation |
| Scenery scenes | 270 real .cv scene files — real-world node/connection patterns |
| Manual reference | Curated scripting patterns and best practices |
| Scripts | Example JavaScript scripts |
The public knowledge base does not include Discord community data (private).
Building the Knowledge Base (contributors)
1. Set up Python
cd etl
pip install -r requirements.txt
2. Configure .env
LANCEDB_PATH=C:/Users/yourname/.cavalry-assistant/lancedb
DISCORD_TOKEN=your_token
DISCORD_CHANNEL_IDS=channel_id_1,channel_id_2
SCENERY_COOKIE=your_session_cookie
3. Run ETL
cd .. # project root
# Public sources
python etl/ingest.py --source docs
python etl/ingest.py --source scenery
python etl/ingest.py --source manual
python etl/ingest.py --source scripts
python etl/ingest.py --source cv
# Private sources (stays local, never exported)
python etl/ingest.py --source discord
4. Export and publish a public release
python etl/export_public_db.py --zip
gh release create v1.x --title "Knowledge Base v1.x" data/lancedb_public.zip
5. Add new scenes from Scenery
python etl/scrape_scenery.py
python etl/ingest.py --source cv
python etl/export_public_db.py --zip
Good to know
- Stallion always responds
"Success"— check Cavalry’s console panel for actual errors - Always start scene-modifying scripts with
api.stop() - Full API reference:
prompts/cavalry-best-practices.md - The public DB is a clean snapshot — no Discord messages, no credentials, no user data
Credits
Built with Cavalry by Scene Group, Stallion, Model Context Protocol SDK by Anthropic, LanceDB, and Ollama + nomic-embed-text.
Knowledge base sourced from Cavalry official docs, Scenery, and the Cavalry community.
Install
This server does not publish a one-line install command.
Open the repository installation guide New to MCP? Start with the mcpskill.org guide →