stella-mcp

# Stella MCP Server A vendor-neutral [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for creating and manipulating [Stella](https://www.iseesystems.com/store/products/stella-professional.aspx) system dynamics models. Any compliant MCP client can build, read, validate, and save `.stmx` files in the XMILE format; optional host features still vary. ## What is this for? **Stella** is a system dynamics modeling tool used for simulating complex systems in fields like ecology, biogeochemistry, economics, and engineering. This MCP server allows AI assistants to: - **Create models from scratch** - Build stock-and-flow diagrams programmatically - **Read existing models** - Parse and understand .stmx files - **Validate models** - Check for errors like undefined variables or missing connections - **Modify models** - Add stocks, flows, auxiliaries, and connectors - **Save models** - Export valid XMILE files that open in Stella Professional This is particularly useful for: - Teaching system dynamics modeling - Rapid prototyping of models through natural language - Batch creation or modification of models - Documenting and explaining existing models ## Installation ### From PyPI ```bash pip install stella-mcp ``` ### From source ```bash git clone https://github.com/bradleylab/stella-mcp.git cd stella-mcp pip install -e . ``` ### Requirements - Python 3.10+ - `mcp>=2.0.0,<3` ## Configuration ### Via uvx (no install required) If you have [uv](https://docs.astral.sh/uv/) installed, the lowest-friction configuration runs the published package directly: ```json { "mcpServers": { "stella": { "command": "uvx", "args": ["stella-mcp"] } } } ``` ### Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "stella": { "command": "stella-mcp" } } } ``` ### Claude Code Add to your `.claude/settings.json`: ```json { "mcpServers": { "stella": { "command": "stella-mcp" …