SuperAPI AI 工具集

configure-putior-mcp

智能体与模型

查看项目

更新于 10-16 03:42

技能介绍

用途:把 putior 的 MCP 服务器接入 AI 助手(Claude Code、Claude Desktop),使其能直接调用工作流标注与图表生成工具;也可选配 ACP 服务器实现智能体间通信。

主要能力:暴露约 16 个工具,分四类。核心工作流(5):put 扫描文件中的 PUT 标注、put_diagram 生成 Mermaid 图、put_auto 从代码自动检测工作流、put_generate 生成标注建议、put_merge 合并手动与自动标注,均支持 exclude 正则过滤。参考/发现(7):get_comment_prefix、get_supported_extensions、list_supported_languages、get_detection_patterns、get_diagram_themes、putior_skills、putior_help。工具类(3):is_valid_put_annotation、split_file_list、ext_to_language。配置(1):set_putior_log_level。

使用方式:先安装依赖 remotes::install_github("posit-dev/mcptools") 与 install.packages("ellmer")。Claude Code 用 claude mcp add putior -- Rscript -e "putior::putior_mcp_server()",WSL 下改用 Windows Rscript 路径;Claude Desktop 编辑 %APPDATA%\Claude\claude_desktop_config.json 的 mcpServers 后重启。用 putior::putior_mcp_tools() 验证工具数量与名称。可选 ACP:install.packages("plumber2") 后运行 putior::putior_acp_server(),默认 localhost:8080,可用 host/port 参数调整。

适用场景:为 AI 助手启用交互式工作流标注与可视化、新开发环境集成、安装 putior 后做 AI 辅助文档、通过 ACP 搭建自动化流水线。

限制:需先安装 putior;mcptools 与 ellmer 缺一不可;Claude Desktop 改配置后必须重启;renv 隔离可能导致包找不到;ACP 默认端口 8080 易冲突;MCP 调用中 put_diagram 的 palette 参数需 putior_theme 对象,无法经 JSON 序列化,只能用内置 theme 字符串,自定义调色板需直接用 R;仅暴露部分工具可用 include 参数。具体版本与收费信息暂未提供。