The Systems MCP server enables interaction with the lethain:systems
library for systems modeling, providing two main capabilities:
- Run Systems Models: Execute systems model specifications using the
run_systems_model
function, optionally specifying the number of rounds, and receive the output as JSON. - Load Documentation: Load systems documentation, examples, and specification details into the context window to enhance the model's ability to generate accurate systems specifications.
Provides tools for interacting with the lethain library for systems modeling, allowing users to run and visualize systems models directly through the interface.
systems-mcp
systems-mcp is an MCP server for interacting with
the lethain:systems
library for systems modeling.
It provides two tools:
run_systems_model
runs thesystems
specification of a systems model. Takes two parameters, the specification and, optionally, the number of rounds to run the model (defaulting to 100).load_systems_documentation
loads documentation and examples into the context window. This is useful for priming models to be more helpful at writing systems models.
It is intended for running locally in conjunction with Claude Desktop or a similar tool.
Usage
Here's an example of using systems-mcp
to run and render a model.
Here is the artifact generated from that prompt, including the output from running the systems model.
Finally, here is an example of using the load_systems_documentation
tool to prime
the context window and using it to help generate a systems specification.
This is loosely equivalent to including lethain:systems/README.md
in the context window,
but also includes a handful of additional examples
(see the included files in ./docs/.
Then you can render the model as before.
The most interesting piece here is that I've never personally used systems
to model a social network,
but the LLM was able to do a remarkably decent job at generating a specification despite that.
Installation
These instructions describe installation for Claude Desktop on OS X. It should work similarly on other platforms.
- Install Claude Desktop.
- Clone systems-mcp into
a convenient location, I'm assuming
/Users/will/systems-mcp
- Make sure you have
uv
installed, you can follow these instructions - Go to Cladue Desktop, Setting, Developer, and have it create your MCP config file.
Then you want to update your
claude_desktop_config.json
. (Note that you should replacewill
with your user, e.g. the output ofwhoami
.Then add this section: - Close Claude and reopen it.
- It should work...
local-only server
The server can only run on the client's local machine because it depends on local resources.
An MCP server that allows users to run and visualize systems models using the lethain library, including capabilities to run model specifications and load systems documentation into the context window.
Related Resources
Related MCP Servers
- -securityAlicense-qualityAn MCP server that provides tools to load and fetch documentation from any llms.txt source, giving users full control over context retrieval for LLMs in IDE agents and applications.Last updated -553PythonMIT License
- -securityFlicense-qualityA Filesystem MCP server that allows an LLM to read and list files from a specified directory on your local machine through the Model Context Protocol.Last updated -2Python
- AsecurityFlicenseAqualityAn MCP server that allows AI models to execute system commands on local machines or remote hosts via SSH, supporting persistent sessions and environment variables.Last updated -124817TypeScript
- -securityFlicense-qualityAn MCP server that fetches real-time documentation for popular libraries like Langchain, Llama-Index, MCP, and OpenAI, allowing LLMs to access updated library information beyond their knowledge cut-off dates.Last updated -2Python