RealTest MCP Server

An MCP server that gives LLM agents structured access to RealTest backtesting documentation and example scripts. Fixes RealScript hallucinations by providing authoritative function references, searchable docs, and verified example scripts at query time.

Requirements

• Python 3.11+
• RealTest installed (for the User Guide PDF and example scripts)

Setup

1. Clone and install

git clone <repo-url>
cd realtest-mcp
pip install -e .

2. Configure paths

Edit config.toml to match your RealTest installation:

[realtest]
pdf_path = "C:\\RealTest\\RealTest User Guide.pdf"

[scripts]
examples = "C:\\RealTest\\Scripts\\Examples"
user_scripts = []

[database]
path = "%LOCALAPPDATA%\\RealTestMcp\\chromadb"

All paths support %VAR% environment variable expansion. Individual fields can also be overridden via environment variables: REALTEST_MCP_PDF_PATH, REALTEST_MCP_EXAMPLES, REALTEST_MCP_DB_PATH.

3. Ingest docs and scripts

python -m realtest_mcp ingest
python -m realtest_mcp status

4. Configure your MCP client

Add to .mcp.json in your project (or pass via --mcp-config):

{
  "mcpServers": {
    "realtest": {
      "command": "python",
      "args": ["-m", "realtest_mcp", "serve"]
    }
  }
}

5. (Optional) Add your own scripts

Add directories to user_scripts in config.toml, then re-run ingest.

Commands

Command	Description
serve	Start MCP server (StdIO transport, managed by client)
ingest	Extract PDF docs, index scripts into ChromaDB
status	Show database statistics (chunk counts, timestamps)

MCP Tools

Six tools are exposed to MCP clients:

Tool	Description
get_primer	Load the RealScript mental model (call once per session)
get_reference	Look up exact element docs with alias resolution
get_section	Fetch narrative documentation sections by title
list_elements	Browse element categories and their contents
search_docs	Semantic search over documentation
search_scripts	Find example scripts by concept or technique

See API Reference for full parameter details and usage examples.

Documentation

• Architecture Overview -- system design, components, data flow
• API Reference -- tool parameters, resolution logic, workflows
• Roadmap -- proposed enhancements