{"_id":"@cosmosdeng/nodeflow-mcp","name":"@cosmosdeng/nodeflow-mcp","dist-tags":{"next":"0.4.0-next.2","latest":"0.4.0-next.2"},"versions":{"0.4.0-next.2":{"name":"@cosmosdeng/nodeflow-mcp","version":"0.4.0-next.2","description":"NodeFlow MCP stdio adapter — lets AI agents (WorkBuddy / MCP clients) operate a running NodeFlow via its local Agent Bridge (http://127.0.0.1:8787).","author":{"name":"cosmosdeng","email":"dycosmos@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cosmosdeng/nodeflow.git"},"keywords":["nodeflow","mcp","model-context-protocol","flowchart","workbuddy","opencode","electron"],"main":"dist/index.js","types":"dist/index.d.ts","bin":{"nodeflow-mcp":"dist/cli.js"},"exports":{".":{"types":"./dist/index.d.ts","require":"./dist/index.js","import":"./dist/index.js"}},"engines":{"node":">=18"},"scripts":{"build":"node scripts/build.mjs","prepack":"npm run build","test":"node scripts/build.mjs && node --test test/package.check.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^4.5.4"},"devDependencies":{"esbuild":"^0.25.0","typescript":"^5.7.2"},"gitHead":"656ea612a83e1f27ddc0fa89be2c4ebe912a7b14","_id":"@cosmosdeng/nodeflow-mcp@0.4.0-next.2","bugs":{"url":"https://github.com/cosmosdeng/nodeflow/issues"},"homepage":"https://github.com/cosmosdeng/nodeflow#readme","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-ZW42Ffzjp43b0rYxA/Kky8V0ijnB+W1T8Uv9Tw2sU9YD64AxauQrIUTR9i/c6Gfx4f9AKt2Jorzl+ccvpVKo7g==","shasum":"7344cc15216e03057aae05faa1dcfda2ae3abff8","tarball":"https://registry.npmjs.org/@cosmosdeng/nodeflow-mcp/-/nodeflow-mcp-0.4.0-next.2.tgz","fileCount":6,"unpackedSize":40625,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAiuA8pbTPZ04YZe/8z6cx4yIntQYIRMYvLRh62HaudDAiAWbGSuoA3niRReg9LCZDRWhfwlAfJCpGDqWSICa21a3A=="}]},"_npmUser":{"name":"cosmosdeng","email":"dycosmos@icloud.com"},"directories":{},"maintainers":[{"name":"cosmosdeng","email":"dycosmos@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nodeflow-mcp_0.4.0-next.2_1788840709266_0.22830840969234978"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-08T04:11:49.091Z","0.4.0-next.2":"2026-09-08T04:11:49.462Z","modified":"2026-09-08T04:11:49.674Z"},"maintainers":[{"name":"cosmosdeng","email":"dycosmos@icloud.com"}],"description":"NodeFlow MCP stdio adapter — lets AI agents (WorkBuddy / MCP clients) operate a running NodeFlow via its local Agent Bridge (http://127.0.0.1:8787).","homepage":"https://github.com/cosmosdeng/nodeflow#readme","keywords":["nodeflow","mcp","model-context-protocol","flowchart","workbuddy","opencode","electron"],"repository":{"type":"git","url":"git+https://github.com/cosmosdeng/nodeflow.git"},"author":{"name":"cosmosdeng","email":"dycosmos@gmail.com"},"bugs":{"url":"https://github.com/cosmosdeng/nodeflow/issues"},"license":"MIT","readme":"# @cosmosdeng/nodeflow-mcp\n\nNodeFlow 的独立 MCP(stdio)适配器。它让 AI Agent(WorkBuddy / Claude / 任意 MCP Client)通过 MCP 工具操作**正在运行的 NodeFlow**。\n\n```text\nWorkBuddy / MCP Client\n   │  MCP stdio\n   ▼\n@cosmosdeng/nodeflow-mcp      ← 本包(仅 adapter)\n   │  HTTP/JSON(仅本机)\n   ▼\nNodeFlow Agent Bridge          ← NodeFlow next 自动启动于 127.0.0.1:8787\n   ▼\nNodeFlow(Electron / React / Store)\n```\n\n本包**不包含** NodeFlow 本体:\n\n- 不启动 Electron / NodeFlow UI;\n- 不读取 NodeFlow 项目文件;\n- 不访问 Zustand / React DOM / Electron IPC;\n- 不执行任意 shell / eval / 任意本地文件操作。\n\n它只是一个把 MCP Tool 调用翻译成 NodeFlow Agent Bridge 请求的 adapter。\n\n## 使用\n\n前提:NodeFlow **next** 已运行(会自动启动 Agent Bridge)。\n\n```bash\n# 方式一:本仓库开发验证(需已构建)\nnode mcp-server/dist/cli.js\n\n# 方式二:CLI bin(安装到全局/本地后)\nnodeflow-mcp\n\n# 方式三:发布后的任意机器\nnpx -y @cosmosdeng/nodeflow-mcp\n```\n\n默认连接 `http://127.0.0.1:8787`;可用环境变量覆盖:\n\n```bash\nNODEFLOW_MCP_BRIDGE_URL=http://127.0.0.1:8787 nodeflow-mcp\n```\n\n### stdio 规则\n\n- **stdout 只输出 MCP protocol**;所有日志写 stderr,不会污染协议通道。\n- Bridge 不可达时,tool 返回清晰错误(`NodeFlow is not running or Agent Bridge is unavailable at ...`),不会静默崩溃。\n\n### Test Fixture\n\n`reset` / `seed_fixture` 属于 test-only tools,**默认关闭**。仅当同时满足:\n\n```bash\nNODEFLOW_MCP_TEST_FIXTURE=1   # 本包:注册 test-only tools\n```\n\n且 NodeFlow 侧开启 `NODEFLOW_AGENT_TEST_CMDS=1` 时,它们才会生效。\n\n## MCP Client 配置\n\n前提:**NodeFlow next 正在运行**,其 Agent Bridge 在 `127.0.0.1:8787`(next 默认自动启动;`NODEFLOW_AGENT_BRIDGE=0` 可关闭)。本包是 MCP Server(连接方),不负责启动 NodeFlow。\n\n### WorkBuddy\n\n推荐在 WorkBuddy 安装 NodeFlow Connector(仓库 `workbuddy/nodeflow/`),其 `mcp.json` 指向本包:\n\n```json\n{\n  \"mcpServers\": {\n    \"nodeflow\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cosmosdeng/nodeflow-mcp\"]\n    }\n  }\n}\n```\n\n### OpenCode\n\n在 `opencode.json`(或 `opencode.jsonc`)中按 OpenCode 官方 schema 配置为 local MCP server:\n\n```jsonc\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"nodeflow\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@cosmosdeng/nodeflow-mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n> 通用 stdio 原则:任意 MCP Client 都可用 `npx -y @cosmosdeng/nodeflow-mcp`\n> (或本机已构建的 `node .../mcp-server/dist/cli.js`)作为 stdio 命令启动本包。\n\n## 开发\n\n```bash\n# 从仓库单一源构建 dist(cli.js / index.js / index.d.ts)\ncd mcp-server && npm run build\n\n# 运行独立包测试(node --test)\nnpm test\n```\n\n构建通过 esbuild 把仓库内 `src/mcp/*` 与 `src/agent/types` 打包进 `dist/`,外部依赖仅 `@modelcontextprotocol/sdk` 与 `zod`;不会把 NodeFlow 的 Electron / React 代码打进来。\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-67cf55dc39fe30ec96802accb2c366e4"}