pycycle-mcp 0.1.0

An MCP around pyCycle/OpenMDAO cycle workflows

pycycle-mcp

pycycle-mcp is a lightweight Model Context Protocol server for pyCycle/OpenMDAO engine-cycle workflows. The repository includes deterministic examples/tests so local development and CI can validate tooling contracts without requiring a full runtime installation of pyCycle/OpenMDAO assets.

Overview

The project currently provides:

• A FastMCP-powered server with stdio and HTTP-compatible transports.
• Tooling for cycle lifecycle, variable inspection/updates, execution, sweeps, and total-derivative evaluation.
• Pydantic-backed validation with structured MCP-style error payloads.
• Deterministic examples for repository scaffolding checks and smoke tests.

Quickstart

Requires Python 3.12+.

python3 -m venv .venv
source .venv/bin/activate
make dev
make test
make ci

Start the server over stdio:

pycycle-mcp --transport stdio

Inspect the non-blocking HTTP transport configuration example:

PYTHONPATH=src python3 examples/server/http_launch_config.py

Examples

The examples are deterministic and aligned with the current repository contracts.

• Examples index: examples/README.md
• Tool discovery: examples/client/tool_discovery.py
• Session lifecycle: examples/cpacs/session_lifecycle.py
• Export snapshot: examples/cpacs/export_snapshot.py

Docs

• Docs source: docs/index.rst
• Published docs (placeholder): https://cmudrc.github.io/pycycle-mcp/

Build the docs locally with:

make docs

Python API Rename

The package import root is now:

• pycycle_mcp (new)

Legacy pre-rename import paths and CLI aliases are intentionally removed.

Contributing

Contribution guidelines live in CONTRIBUTING.md.