pfc-mcp

Name: pfc-mcp
Author: yusong652

Verified

MCP server connecting AI agents to ITASCA PFC — run DEM simulations through natural conversation

100stars

11forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/yusong652/pfc-mcp

Getting Started

Guides for using ai agents skills like pfc-mcp.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 6/22/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-06-22T09:50:49.068Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is pfc-mcp?

pfc-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by yusong652. MCP server connecting AI agents to ITASCA PFC — run DEM simulations through natural conversation. It has 100 GitHub stars.

Is pfc-mcp safe to use?

Yes. pfc-mcp passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install pfc-mcp?

Clone the repository with "git clone https://github.com/yusong652/pfc-mcp" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is pfc-mcp written in?

pfc-mcp is primarily written in Python. It is open-source under yusong652 on GitHub, so you can review or fork the full source.

Are there alternatives to pfc-mcp?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh pfc-mcp against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

omegacode pi-ask-user

pfc-mcp

English | 简体中文

pfc3d>model new ;now, with LLM.

pfc-mcp connects AI agents to ITASCA PFC — Itasca's discrete element method (DEM) code — through the Model Context Protocol. Browse documentation, run simulations, and execute code, all through natural conversation.

pfc3d>model solve ;LLM solves.

pfc-mcp demo

Tools (10)

5 documentation tools — browse and search PFC 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 PFC 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/pfc-mcp/main/docs/agentic/pfc-mcp-bootstrap.md

Manual Setup

1. Register the MCP server in your client config:

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

2. Start the bridge from inside PFC:

Download addon.py, then use either of these two flows inside PFC:

Copy the file contents into the PFC IPython console and run them
Or download the file and execute it in PFC GUI

Verify

Restart your AI agent (Claude Code, Codex CLI, Gemini CLI, etc.) and ask it to call pfc_execute_code to verify the connection.

Daily Startup

Once first-time setup is done, each new PFC session only needs the bridge re-started — run this in PFC'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 PFC support - command docs for PFC 6.0, 7.0, and 9.0 via the version parameter
Hierarchical documentation browsing - agents navigate the PFC 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.