yuppie-mcp-fnf

阿里云 FNF (Serverless 工作流) MCP Server — 让 AI 助手通过 MCP 协议操作阿里云 FNF。

功能

流程管理

• 查询流程详情: 获取指定流程的名称、类型、执行模式、描述等信息
• 流程列表: 批量查询流程，支持分页

执行管理

• 异步启动执行: 启动流程执行并立即返回
• 同步启动执行: 启动流程执行并等待完成
• 停止执行: 停止正在运行的执行
• 查询执行状态: 获取指定执行的状态信息
• 执行历史列表: 查询流程的执行记录列表，支持分页
• 执行步骤详情: 获取执行的每个步骤的详细信息

快速开始

安装

pip install yuppie-mcp-fnf

配置

通过环境变量配置阿里云凭证：

export FNF_ACCESS_KEY_ID=your_access_key_id
export FNF_ACCESS_KEY_SECRET=your_access_key_secret
# 可选：指定 endpoint（默认 cn-hangzhou.fnf.aliyuncs.com）
export FNF_ENDPOINT=cn-hangzhou.fnf.aliyuncs.com

运行

yuppie-mcp-fnf

MCP 集成

Claude Code

在 .mcp.json 中添加：

{
  "mcpServers": {
    "alibabacloud-fnf": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--refresh", "yuppie-mcp-fnf"],
      "env": {
        "FNF_ACCESS_KEY_ID": "<your_access_key_id>",
        "FNF_ACCESS_KEY_SECRET": "<your_access_key_secret>",
        "FNF_ENDPOINT": "cn-hangzhou.fnf.aliyuncs.com"
      }
    }
  }
}

Cursor

在 ~/.cursor/mcp.json 中添加同上配置。

Cherry Studio / Claude Desktop / OpenCode

参照上方 env 字段，按各自 MCP 配置格式填入即可。

环境变量

开发

uv pip install -e ".[dev]"
uv run pytest -v

本地调试

# 方式1: 直接通过环境变量运行
FNF_ACCESS_KEY_ID=xxx FNF_ACCESS_KEY_SECRET=xxx uv run yuppie-mcp-fnf

# 方式2: 使用 .env 文件（推荐）
# 先编辑 .env 填入真实凭证，然后：
uv run yuppie-mcp-fnf

# 方式3: 使用 MCP Inspector 调试
npx @modelcontextprotocol/inspector uv run yuppie-mcp-fnf

工具列表

入参定义（fnf_describe_flow_inputs）

fnf_describe_flow_inputs 可以从 Flow 的 States 中解析出入参定义，让 AI 知道每个参数的格式。

在 FNF Flow 中创建一个 模板转换 节点（Action: Extensions:TemplateTransform）， template 字段写入参的 JSON 定义：

支持的类型

示例

{
    "title": {"type": "string", "label": "文章标题", "required": 1},
    "partment": {"type": "select", "label": "部门", "enum": ["销售部", "技术部"]},
    "count": {"type": "int", "label": "数量"},
    "info": {"type": "object", "label": "详细信息"},
    "tags": {"type": "array[string]", "label": "标签"},
    "cover": {"type": "file", "label": "封面URL"},
    "attachments": {"type": "file-list", "label": "附件列表"}
}

许可证

MIT