AI导哈

模型上下文协议服务器

FlowSpec的模型上下文协议服务器，用于向Claude Code和其他MCP兼容的AI工具公开项目规范。

  • by Jktfe
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Jktfe/flowspec-mcp

使用说明

流程规范mcp

MCP（模型上下文协议）服务器 流量规格 --将项目规范暴露给Claude Code和其他MCP兼容的AI工具。

快速开始

添加到您的 ~/.claude.json:

{
  "mcpServers": {
    "flowspec": {
      "command": "npx",
      "args": ["-y", "flowspec-mcp"],
      "env": {
        "FLOWSPEC_MODE": "cloud",
        "DATABASE_URL": "your-neon-connection-string",
        "FLOWSPEC_USER_ID": "your-clerk-user-id"
      }
    }
  }
}

本地模式（带FlowSpec桌面）

{
  "mcpServers": {
    "flowspec": {
      "command": "npx",
      "args": ["-y", "flowspec-mcp"],
      "env": {
        "FLOWSPEC_MODE": "local"
      }
    }
  }
}

本地模式连接到FlowSpec桌面服务器 http://localhost:3456.

环境变量

变量 必填 默认 描述
FLOWSPEC_MODE 没有 cloud cloud 对于直接Neon SQL， local 用于桌面服务器HTTP
DATABASE_URL 云模式 -- Neon Postgres连接字符串
FLOWSPEC_USER_ID 云模式 -- 职员用户ID--在 flowspec.app/account
FLOWSPEC_LOCAL_URL 没有 http://localhost:3456 桌面服务器URL（本地模式）

可用工具（v5.6.0--32个工具）

集 FLOWSPEC_TOOLS=core 仅适用于11个基本工具。默认值(all)加载全部32个。

阅读工具

  • flowspec_list_projects --列出所有项目及其名称和日期
  • flowspec_get_json --获取项目的完整JSON规范（针对Claude Code进行了优化）
  • flowspec_get_project --获取原始canvas_state JSON
  • flowspec_search_nodes --在所有项目中按标签搜索节点
  • flowspec_get_screen_context --获取屏幕/区域/元素结构

写入工具

  • flowspec_create_project --创建新项目
  • flowspec_update_project --更新项目名称或画布状态
  • flowspec_delete_project --删除项目
  • flowspec_clone_project --克隆项目以进行备份或分支
  • flowspec_create_node --添加节点（数据点、组件、转换、表、参与者）
  • flowspec_update_node --更新节点数据或位置
  • flowspec_delete_node --删除节点和连接的边
  • flowspec_create_edge --使用边类型连接两个节点
  • flowspec_update_edge --更新边类型、标签或手柄位置
  • flowspec_delete_edge --移除边缘
  • flowspec_analyse_project --运行孤立节点和重复标签分析
  • flowspec_validate_project --验证数据流语义和类型匹配

批量/导入工具

  • flowspec_import_json --导入JSON规范（创建/合并节点、边、屏幕）
  • flowspec_auto_layout --使用dagre层次布局自动排列节点

屏幕和区域工具

  • flowspec_upload_image --上传线框图像并获取其URL
  • flowspec_create_screen --将线框屏幕添加到项目中
  • flowspec_update_screen --更新屏幕名称或图像属性
  • flowspec_delete_screen --删除屏幕及其区域
  • flowspec_add_region --在屏幕上添加带注释的区域
  • flowspec_update_region --更新区域位置、大小或链接元素
  • flowspec_remove_region --从屏幕上删除一个区域

决策树工具

  • flowspec_list_decision_trees --列出项目的决策树
  • flowspec_get_decision_tree --获取具有完整节点/边结构的决策树
  • flowspec_delete_decision_tree --删除决策树
  • flowspec_analyse_decision_tree --分析树的深度、结果和问题

无聊的逻辑板工具

  • flowspec_get_logic_board --获取逻辑板（输入/输出/过程/决策画布）
  • flowspec_upsert_logic_board --保存项目的逻辑板状态

发展

npm install
npm run build
node dist/index.js

备注

  • MCP SDK固定到 1.12.1 由于以后版本中的zod v4兼容性限制
  • 需要Node.js>=18.0.0

许可证

麻省理工学院

相关 MCP