Text2Sim

v1.0.0Data Science & MLstable

Text2Sim MCP Server is a conversational simulation engine that transforms natural language into working simulation models. Supporting Discrete-Event Simulation (DES) and System Dynamics (SD), it integrates with LLMs via the Model Context Protocol (MC

llm-agentllm-toolsmcp-serverpysdsimpy
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is Text2Sim?

Text2Sim is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to text2sim mcp server is a conversational simulation engine that transforms natural language into working simulation models. supporting discrete-event simulation (des) and system dynamics (sd), it integ...

Text2Sim MCP Server is a conversational simulation engine that transforms natural language into working simulation models. Supporting Discrete-Event Simulation (DES) and System Dynamics (SD), it integrates with LLMs via the Model Context Protocol (MC

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Text2Sim MCP Server is a conversational simulation engine th

Use Cases

Convert natural language descriptions into Discrete-Event Simulation models. Create System Dynamics simulations from text input. Build and execute simulation workflows for analysis.
IamCatoBot

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedApr 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx text2sim-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Text2Sim

Text2Sim is a conversational simulation engine MCP server that transforms natural language descriptions into working simulation models, supporting both Discrete-Event Simulation (DES) via SimPy and System Dynamics (SD) via PySD. It exposes 16 MCP tools for building, validating, running, saving, and templating simulation models directly through an AI conversation — no prior simulation programming knowledge required. Data scientists, operations researchers, and engineers who want to rapidly prototype and analyze systems (queues, supply chains, epidemiological models, etc.) through natural language will find it a powerful assistant.

Prerequisites

  • Python 3.10 or later with uv package manager installed
  • Git to clone the repository (no PyPI package available)
  • SimPy and PySD Python packages (installed via uv sync)
  • An MCP-compatible client: Claude Desktop, Cursor, or Claude Code
1

Clone the Text2Sim repository

Clone the repository from GitHub. There is no published package — you run the server from the cloned source.

git clone https://github.com/IamCatoBot/text2sim-MCP-server.git
cd text2sim-MCP-server
2

Install dependencies with uv

Use uv to install all Python dependencies including SimPy (for DES) and PySD (for System Dynamics).

uv sync
3

Add Text2Sim to your MCP client configuration

Add the server to your Claude Desktop or Cursor MCP config. Replace PATH_TO_TEXT2SIM_MCP_SERVER with the absolute path to the cloned repository.

{
  "mcpServers": {
    "Text2Sim MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/text2sim-MCP-server",
        "run",
        "python",
        "-m",
        "mcp_server"
      ],
      "env": {}
    }
  }
}
4

Validate a simulation model

Before running simulations, use the validate_model tool to check your configuration for errors. The tool provides specific guidance on how to fix any issues found.

5

Run a simulation and analyze results

Use simulate_des for queue/process/event models or simulate_sd for stock-and-flow models. Use run_multiple_simulations for statistical analysis across replications.

Text2Sim Examples

Client configuration

Claude Desktop MCP configuration for the Text2Sim simulation engine server.

{
  "mcpServers": {
    "Text2Sim MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/text2sim-MCP-server",
        "run",
        "python",
        "-m",
        "mcp_server"
      ],
      "env": {}
    }
  }
}

Prompts to try

Example natural language prompts to build and run simulations with Text2Sim.

- "Simulate a coffee shop with 2 servers, customers arriving every 3 minutes, and 5-minute average service time for 8 hours"
- "Build a system dynamics model of population growth with a birth rate of 0.02 and death rate of 0.01"
- "Run 50 replications of the queue simulation and give me the average wait time with 95% confidence interval"
- "Convert this Vensim .mdl file to a PySD simulation model"
- "Save this simulation as a template called 'single-server-queue' for reuse"

Troubleshooting Text2Sim

uv sync fails with dependency errors

Ensure Python 3.10+ is installed and uv is up to date ('pip install -U uv'). If SimPy or PySD have version conflicts, check the pyproject.toml for pinned versions and install them manually with 'uv pip install simpy pysd'.

validate_model reports schema errors

Use the get_schema_help tool to retrieve complete schema documentation with examples for DES and SD model formats. Common issues are missing required fields like 'run_time' for DES or incorrect AST structure for SD models.

MCP server not found in Claude Desktop after configuration

Verify the --directory path in your MCP config is an absolute path (not relative) pointing to the cloned text2sim-MCP-server folder. Ensure 'uv' is in your system PATH — test with 'which uv' in your terminal.

Frequently Asked Questions about Text2Sim

What is Text2Sim?

Text2Sim is a Model Context Protocol (MCP) server that text2sim mcp server is a conversational simulation engine that transforms natural language into working simulation models. supporting discrete-event simulation (des) and system dynamics (sd), it integrates with llms via the model context protocol (mc It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Text2Sim?

Follow the installation instructions on the Text2Sim GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Text2Sim?

Text2Sim works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Text2Sim free to use?

Yes, Text2Sim is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "text2sim-mcp": { "command": "npx", "args": ["-y", "text2sim-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Text2Sim?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides