YF

yusong652/flac-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

41 stars 5 forks 质量 72 趋势 16MIT

连接 AI 代理与 ITASCA FLAC 的 MCP 服务器——通过自然对话运行连续模拟

概览

它被——一个覆盖 FLAC、PFC、3DEC、MPoint 和 MassFlow 的单一多引擎 MCP 服务器所取代。将 MCP 客户端配置从 uvx flac-mcp 更新为 uvx itasca-mcp(通过软件参数选择 FLAC 文档)。这里没有计划再发布新的版本。 通过模型上下文协议将AI代理与ITASCA FLAC连接——通过自然对话浏览文档、运行模拟和执行代码。 —— 浏览和搜索 FLAC 命令、Python API 及参考文档。无需桥接。 —— 互动式REPL、任务提交、进度监控、中断和历史记录。需要桥接。 把这些复制给你的AI代理,让它自我配置: 下载 addon.py,然后在FLAC中使用以下两种流程中的任一: - 将文件内容复制到 FLAC IPython 控制台并运行 - 或下载文件并在 FLAC 图形界面中执行 重启你的AI代理(Claude Code、Codex CLI、Gemini CLI等),让它呼叫flac_execute_code来验证连接。

概述(AI 翻译)

[!警告] flac-mcp 已被弃用并冻结。 它被 取代 itasca-mcp — 单一 多引擎MCP服务器,涵盖FLAC、PFC、3DEC、MPoint和MassFlow。 将MCP客户端配置从uvx flac-mcp更新为uvx itasca-mcp (通过software参数选择FLAC文档)。没有后续版本 在这里计划好的。

英文 |简体中文

flac3d>model new ;now, with LLM.

flac-mcp 通过模型上下文协议将 AI 代理连接到 ITASCA FLAC——通过自然对话浏览文档、运行模拟和执行代码。

flac3d>model solve ;LLM solves.

工具 (10)

5个文档工具 — 浏览和搜索FLAC命令、Python API和参考文档。无需桥接。

5 个执行工具 — 交互式 REPL、任务提交、进度监控、中断和历史记录。需要桥接。

首次布置

先决条件

  • ITASCA FLAC 6.0、7.0 或 9.0 安装
  • uv 安装(针对uvx)

智能设定(推荐)

把这些复制给你的AI代理,让它自我配置:

手动设置

1.在客户端配置中注册MCP服务器:

2.从FLAC内部启动桥接:

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

flac-mcp

[!WARNING] flac-mcp is deprecated and frozen. It is superseded by itasca-mcp — a single multi-engine MCP server covering FLAC, PFC, 3DEC, MPoint, and MassFlow. Update your MCP client config from uvx flac-mcp to uvx itasca-mcp (select FLAC docs via the software parameter). No further releases are planned here.

English | 简体中文

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)

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()
在 GitHub 查看完整 README

安装

uvx flac-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "flac-mcp": { "command": "uvx", "args": ["flac-mcp"] } } }