pycycle mcp
  
pycycle-mcp 是pyCycle/OpenMDAO的轻量级模型上下文协议服务器 发动机循环工作流程。存储库包括确定性示例/测试,因此 本地开发和CI可以验证工具合同,而不需要完整的 pyCycle/OpenMDAO资产的运行时安装。
概述
该项目目前提供:
- 支持FastMCP的服务器,具有stdio和HTTP兼容的传输。
- 用于循环生命周期、变量检查/更新、执行、扫描的工具,
以及总导数评估。
- Pydantic支持的验证,带有结构化MCP风格的错误有效载荷。
- 存储库脚手架检查和烟雾测试的确定性示例。
快速入门
需要Python 3.12以上。
python3 -m venv .venv
source .venv/bin/activate
make dev
make test
make ci通过stdio启动服务器:
pycycle-mcp --transport stdio检查非阻塞HTTP传输配置示例:
PYTHONPATH=src python3 examples/server/http_launch_config.py例子
这些示例具有确定性,并与当前存储库保持一致 合同。
- 示例索引:
examples/README.md - 工具发现:
examples/client/tool_discovery.py - 会话生命周期:
examples/cpacs/session_lifecycle.py - 导出快照:
examples/cpacs/export_snapshot.py
文档
- 文档来源:
docs/index.rst - 已发布文档(占位符):
使用以下命令在本地构建文档:
make docsPython API重命名
包导入根目录现在是:
pycycle_mcp新
有意保留旧的预重命名导入路径和CLI别名 远离的。
共享CPACS集成
该MCP包括 CPACS适配器 (src/pycycle_mcp/cpacs_adapter.py)那个 将pyCycle连接到共享的CPACS飞机分析管道。
它做什么
适配器从CPACS读取发动机参数和气动阻力,运行一个真实的 OpenMDAO/pyCycle涡扇发动机循环分析,并写入性能结果--net 推力、TSFC、OPR、BPR、燃油流量 //mcpResults.
| 方向 | XPath |
|---|---|
| 读取 | .//vehicles/engines, .//analysisResults/aero/coefficients/CD |
| 写入 | .//vehicles/engines/engine/analysis/mcpResults (Fn、TSFC、OPR、BPR、燃油流量) |
作为管道的一部分运行
python pipeline/shared_cpacs_orchestrator.py D150_v30.xml --mcps tigl su2 pycycle mission看 cmudrc/飞机分析 为了 完整的管道文档、版本控制细节和安装说明。
相关MCP服务器
| MCP | 存储库 |
|---|---|
| TiGL(几何) | cmudrc/tigl-mcp |
| SU2(CFD空气动力学) | CMUDRC/SU2-MCP |
| 任务(轨迹/燃料) | cmudrc/任务mcp |
贡献
贡献指南 CONTRIBUTING.md.
