flac-mcp
MCP server connecting AI agents to ITASCA FLAC — run continuum simulations through natural conversation
Install / Use
claude mcp add yusong652 -- npx -y github:yusong652/flac-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of flac-mcp
flac-mcp scores 73/100 on our quality scale, 850th of 944 AI & Machine Learning skills we index.
Its MCP Server is 4.2 KB long, well organised into 13 sections with 3 code examples: a solid amount of guidance for an agent.
It has 43 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 95/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
flac-mcp compared with similar skills
All 4 of these similar skills score higher than flac-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| flac-mcp (this skill)by yusong652 | 73 | 43 | 5mo ago | MCP Server |
| claude-memby thedotmack | 100 | 118.5k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.3k | 1d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install flac-mcp?
- Run
claude mcp add yusong652 -- npx -y github:yusong652/flac-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does flac-mcp work with?
- It is written for Claude Code, Claude Desktop, Gemini CLI and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is flac-mcp safe to use?
- It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is flac-mcp still maintained?
- The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubflac-mcp
<p align="center"> <img src="https://raw.githubusercontent.com/yusong652/flac-mcp/assets/header.png" width="70%" alt="flac-mcp — MCP Server for ITASCA FLAC"> </p>[!WARNING]
flac-mcpis deprecated and frozen. It is superseded byitasca-mcp— a single multi-engine MCP server covering FLAC, PFC, 3DEC, MPoint, and MassFlow. Update your MCP client config fromuvx flac-mcptouvx itasca-mcp(select FLAC docs via thesoftwareparameter). No further releases are planned here.
flac3d>model new ;now, with LLM.
flac-mcp connects AI agents to ITASCA FLAC through the Model Context Protocol — browse documentation, run simulations, and execute code, all through natural conversation.
flac3d>model solve ;LLM solves.
Tools (10)
5 documentation tools — browse and search FLAC commands, Python API, and reference docs. No bridge required.
5 execution tools — interactive REPL, task submission, progress monitoring, interruption, and history. Requires bridge.
First-time Setup
Prerequisites
- ITASCA FLAC 6.0, 7.0, or 9.0 installed
- uv installed (for
uvx)
Agentic Setup (Recommended)
Copy this to your AI agent and let it self-configure:
Fetch and follow this bootstrap guide end-to-end:
https://raw.githubusercontent.com/yusong652/flac-mcp/main/docs/agentic/flac-mcp-bootstrap.md
Manual Setup
1. Register the MCP server in your client config:
{
"mcpServers": {
"flac-mcp": {
"command": "uvx",
"args": ["flac-mcp"]
}
}
}
2. Start the bridge from inside FLAC:
Download addon.py, then use either of these two flows inside FLAC:
- Copy the file contents into the FLAC IPython console and run them
- Or download the file and execute it in FLAC GUI
Verify
Restart your AI agent (Claude Code, Codex CLI, Gemini CLI, etc.) and ask it to call flac_execute_code to verify the connection.
Daily Startup
Once first-time setup is done, each new FLAC session only needs the bridge re-started — run this in FLAC's IPython console and you're back online:
import itasca_mcp_bridge
itasca_mcp_bridge.start()
start() checks PyPI for a newer bridge release and self-upgrades before starting. The MCP client config persists.
Features
- Multi-version FLAC support - command docs for FLAC 6.0, 7.0, and 9.0 via the
versionparameter - Hierarchical documentation browsing - agents navigate the FLAC command tree to discover capabilities and boundaries, reducing hallucinated commands
- Enhanced plot documentation - plot items reference docs supplementing the official documentation
- Interactive REPL - rapid iteration before committing to full scripts; agents can quickly test and refine code
- Task lifecycle management - submit long-running simulations, monitor progress, interrupt running tasks, and browse task history
- Multi-client compatible - works with Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI, OpenCode, toyoura-nagisa, and other MCP clients
Troubleshooting
See Troubleshooting in the bootstrap guide.
Development
See Developer Guide: Install and Run from Source.
Contributing
PRs and issues are welcome! See the Developer Guide to get started.
License
MIT - see LICENSE.
<!-- mcp-name: io.github.yusong652/flac-mcp -->Related Skills
claude-mem
118.5kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.3kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
