pfc-mcp

English | 简体中文

pfc3d>model new ;now, with LLM.

pfc-mcp 通过 模型上下文协议 (Model Context Protocol) 将 AI 智能体连接到 ITASCA PFC —— 通过自然对话即可浏览文档、运行模拟并执行代码。

pfc3d>model solve ;LLM solves.

工具 (10)

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

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

Related MCP server: mcp-server-terminal

快速开始

前置要求

• 已安装 ITASCA PFC 6.0, 7.0 或 9.0

• 已安装 uv (用于 uvx)

智能体设置 (推荐)

将其复制到您的 AI 智能体中，让其自动配置：

Fetch and follow this bootstrap guide end-to-end:
https://raw.githubusercontent.com/yusong652/pfc-mcp/main/docs/agentic/pfc-mcp-bootstrap.md

手动设置

1. 在您的客户端配置中注册 MCP 服务器：

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

2. 在 PFC 内部启动桥接程序：

下载 addon.py，然后在 PFC 中使用以下两种流程之一：

• 将文件内容复制到 PFC IPython 控制台中并运行

• 或者下载文件并在 PFC GUI 中执行它

验证

重启您的 AI 智能体（Claude Code、Codex CLI、Gemini CLI 等）并要求它调用 pfc_execute_code 以验证连接。

功能

• 多版本 PFC 支持 - 通过 version 参数支持 PFC 6.0、7.0 和 9.0 的命令文档

• 分层文档浏览 - 智能体可以导航 PFC 命令树以发现功能和边界，减少幻觉命令

• 增强的绘图文档 - 绘图项参考文档，作为官方文档的补充

• 交互式 REPL - 在提交完整脚本前进行快速迭代；智能体可以快速测试和优化代码

• 任务生命周期管理 - 提交长时间运行的模拟、监控进度、中断正在运行的任务并浏览任务历史

• 多客户端兼容 - 适用于 Claude Code、Codex CLI、Gemini CLI、GitHub Copilot CLI、OpenCode、toyoura-nagisa 以及其他 MCP 客户端

故障排除

请参阅 故障排除指南。

开发

请参阅 开发者指南：从源码安装和运行。

贡献

欢迎提交 PR 和 Issue！请参阅 开发者指南 以开始。

许可证

MIT - 请参阅 LICENSE。