NetLogo MCP

Name: NetLogo MCP
Author: Razee4315

de Razee4315versión 1.0.2i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.Razee4315/netlogo-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

Create, run, and analyze NetLogo agent-based models through natural conversation

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: NETLOGO_HOME, JAVA_HOME

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: NETLOGO_HOME, JAVA_HOME, NETLOGO_GUI

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "netlogo": {
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add netlogo --env NETLOGO_HOME=your-value --env JAVA_HOME=your-value --env NETLOGO_GUI=your-value -- uvx netlogo-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "netlogo": {
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "netlogo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

NETLOGO_HOME obligatorio env
Path to the NetLogo 7.0+ installation directory (e.g. C:/Program Files/NetLogo 7.0.3)
JAVA_HOME obligatorio env
Path to a Java JDK 11+ installation (not a JRE)
NETLOGO_GUI env
Set to false for headless mode (no NetLogo window); default true

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub Razee4315, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32708 servidores de esta categoría
Publicado en el registro más recientemente que el 12% de los otros 32708 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32708 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro NetLogo MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: NETLOGO_HOME, JAVA_HOME

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.0.2) llegó al registro hace 5 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, OpenTakeoff

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado anteayer

Instalar

OpenTakeoff

de Kentucky-ai

Construction takeoff for AI agents: load plans, set scale, measure, count, export with provenance.

Se ejecuta en tu computadoraActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

The first MCP (Model Context Protocol) server for NetLogo — enabling AI assistants to create, run, and analyze agent-based models through natural conversation.

Works with: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (Copilot), Cline, Continue, Roo Code, Zed, OpenCode, Codex — any tool that supports MCP.

Why NetLogo MCP?

As an AI student taking an Agent-Based Modeling course, I searched for an MCP server to control NetLogo — nothing existed. So I built one.

Instead of manually writing NetLogo code, clicking buttons, and tweaking sliders, you tell your AI assistant what you want in plain English:

"Create a predator-prey model with 100 sheep and 20 wolves. Run it for 500 ticks and show me the population dynamics."

The AI writes the code, runs the simulation, and shows you the results — all through conversation.

By default a real NetLogo window opens (on first use) so you can watch your simulations run live. Headless mode is available for CI or servers.

Features

Create models from code — with real interface widgets: sliders, switches, buttons, monitors
Run simulations and collect tick-by-tick data as markdown tables
Run BehaviorSpace experiments — parallel parameter sweeps via the headless launcher
Export the view as PNG — visible inline in chat
Inspect everything — world state, agent samples, patch grids for heatmaps
CoMSES Net integration — search and safely run models from the largest peer-reviewed ABM library
Built-in references — NetLogo primitives, programming guide, and 6→7 transition guide as MCP resources
Lazy startup — the NetLogo window only opens when you actually use a tool, not when your AI client connects

See docs/TOOLS.md for the full reference of all 25 tools, widget schema, and prompts.

Prerequisites

Requirement	Install via terminal?	How
Python 3.10+	Yes	Windows: `winget install Python.Python.3.12` · macOS: `brew install python@3.12` · Linux: `sudo apt install python3.12`
Java JDK 11+	Yes	Windows: `winget install EclipseAdoptium.Temurin.21.JDK` · macOS: `brew install --cask temurin` · Linux: `sudo apt install openjdk-21-jdk`
NetLogo 7.0+	No — manual	Download from ccl.northwestern.edu/netlogo

Only NetLogo requires manual download. Everything else can be installed via terminal, and the Zero-Config Setup prompt below handles those automatically.

Zero-Config Setup (Recommended)

If you're using an AI coding tool, copy the prompt below into your chat. The AI will detect your OS, find your NetLogo and Java installations, clone the repo, install dependencies, configure your MCP client, and tell you how to use it.

Click to copy the setup prompt

Please set up the NetLogo MCP server for me end-to-end. Follow these steps carefully:

Detect my environment

Identify my OS (Windows / macOS / Linux).
Check Python version (need 3.10+). If missing, tell me to install it first and stop.
Check for Java JDK 11+ (not JRE). Look in common locations (JAVA_HOME env var, standard install dirs). If missing, tell me to install Adoptium Temurin JDK 11+ and stop.
Check for NetLogo 7.0+. Look in common locations:
Windows: C:/Program Files/NetLogo*
macOS: /Applications/NetLogo*
Linux: /opt/netlogo*, ~/netlogo* If NetLogo isn't installed, tell me to download it from https://ccl.northwestern.edu/netlogo/download.shtml and stop.

Install

Run: pip install netlogo-mcp
Verify the netlogo-mcp command is now available on my PATH.

Identify my MCP client

Figure out which AI tool I'm using (Claude Code, Cursor, Windsurf, Cline, Continue, Roo Code, Zed, OpenCode, VS Code Copilot, Codex, or Claude Desktop).
If you're not sure, ask me.

Configure the MCP client

Locate (or create) the correct config file for my client (see https://github.com/Razee4315/NetLogo-MCP/blob/main/docs/CLIENTS.md for exact paths and schemas per client).
Add a netlogo server entry with:
command: netlogo-mcp
env.NETLOGO_HOME: the NetLogo path you detected
env.JAVA_HOME: the JDK path you detected
Use the exact JSON schema for my specific client (e.g. "type": "stdio" for Cursor, "servers" key for VS Code).
Preserve any existing config entries — merge, don't overwrite.
IMPORTANT: configure it for THIS project only (project-scope config file), not globally, unless I say otherwise — a global entry loads the server in every session.

Tell me what to do next

Tell me to fully restart my AI tool for the new MCP server to load.
Tell me the NetLogo window opens on the FIRST model tool call, and that call takes 30–60 seconds while the Java Virtual Machine starts. Tell me NOT to click stop during this wait.
Give me this exact test prompt to try after restart:

"Create a simple predator-prey model with wolves and sheep on a green landscape. Run setup, then run 100 ticks while tracking wolf and sheep counts. Export the view before and after so I can see how the world evolved."

Tell me where models and exports are saved (by default, the current working directory's models/ and exports/ folders) and that I can browse them with the list_models tool.

Do not skip any verification step. If something fails, stop and tell me exactly what failed and how to fix it.

Manual Installation

pip install netlogo-mcp

Then add the server to your MCP client. For Claude Code, add to your project's .mcp.json:

"mcpServers": { "netlogo": { "command": "netlogo-mcp", "args": [], "env": { "NETLOGO_HOME": "C:/Program Files/NetLogo 7.0.3", "JAVA_HOME": "C:/Program Files/Eclipse Adoptium/jdk-25.0.2.10-hotspot" } } } }

Restart Claude Code and verify with /mcp.

Tip: prefer project-scope config (.mcp.json in one project) over global config — a global entry loads the server in every session of every project.

Using Cursor, Windsurf, VS Code, Cline, Continue, Roo Code, Zed, OpenCode, Codex, or Claude Desktop? See docs/CLIENTS.md for exact config for all 11 clients. All configuration options (GUI/headless mode, directories, limits) are in docs/CONFIGURATION.md.

Developing or contributing? Clone the repo and install editable instead:

git clone https://github.com/Razee4315/NetLogo-MCP.git

cd NetLogo-MCP pip install -e ".[dev]"

Docker

The image bakes in NetLogo (headless) with its bundled JRE — no host install needed:

docker build -t netlogo-mcp .

docker run -i --rm netlogo-mcp

MCP client config:

"mcpServers": { "netlogo": { "command": "docker", "args": ["run", "-i", "--rm", "netlogo-mcp"] } } }

Docker runs headless only (no GUI mode). Add -v ./exports:/data/exports to keep exported views and worlds on the host.

Quick Start

Once connected, try these prompts in any MCP client:

> Create a simple NetLogo model with 50 turtles doing a random walk.

Run setup, simulate 100 ticks, and export the view.

Open the Wolf Sheep Predation model and run a parameter sweep

on initial-number-wolves from 10 to 100.

Build a disease spread model with sliders for population size and

infection chance.

The first model tool call takes 30-60 seconds while the JVM starts — the NetLogo window appears when it's ready. Don't click stop. Every call after that is instant.

Troubleshooting

Problem	Solution
`NETLOGO_HOME is not set`	Set the environment variable to your NetLogo install directory
`JAVA_HOME is not set`	Set it to your JDK directory (not JRE)
JVM crashes on startup	Make sure JAVA_HOME points to JDK 11+, not an older version
`No model is loaded`	Call `open_model` or `create_model` before using other tools
First model call hangs for 30-60s	Normal — JVM is warming up. Don't click stop.
NetLogo window opens when my AI client starts	You have `NETLOGO_EAGER_START=true` set, or an old version — by default the window only opens on first tool use
Server won't connect	Run `netlogo-mcp` manually in terminal to see error output

Documentation

docs/TOOLS.md — Full tool reference, widget schema, BehaviorSpace & CoMSES guides
docs/CONFIGURATION.md — All environment variables, GUI vs headless, startup timing
docs/SECURITY.md — Security model and trust boundary
docs/CLIENTS.md — Setup for all 11 MCP clients
docs/DEVELOPMENT.md — Project structure, running tests, architecture notes
CONTRIBUTING.md — How to contribute
CHANGELOG.md — Version history

Listed on

Citing

If you use NetLogo MCP in research or teaching, please cite it — click "Cite this repository" in the GitHub sidebar, or see CITATION.cff.

Author

Saqlain Abbas Email: saqlainrazee@gmail.com GitHub: @Razee4315 LinkedIn: @saqlainrazee

License

This project is licensed under the MIT License — free to use, modify, and distribute for any purpose.

NetLogo MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

OpenTakeoff

README del creador

Why NetLogo MCP?

Features

Prerequisites

Zero-Config Setup (Recommended)

Manual Installation

Docker

Quick Start

Troubleshooting

Documentation

Listed on

Citing

Author

License