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

MCP Tools

Six tools are exposed to MCP clients:

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