Unseen Workflow Compiler

io.github.eyeinthesky6由 GitHub 账号 eyeinthesky6 发布v1.0.1更新于 Oct 27, 2026

Compile SOPs, policies, and playbooks into source-grounded visual flowcharts (SVG, Mermaid, JSON).

已验证Streamable HTTP可网页运行效率与工作流知识与记忆媒体与设计

概览

AI 生成的概览

把 SOP、政策与操作手册编译成有来源依据的流程图，输出 SVG、Mermaid、Excalidraw 与 Studio 链接。

可以做什么
  • 将书面流程或原始运营文本编译为带来源引用的流程图，并输出 SVG、Mermaid、Excalidraw 与 Studio 深链
  • 在多章节文档中先识别出多个候选工作流
  • 按节点标签、角色或删除节点修订已有工作流，或修复连接线与布局
  • 对照引用来源审查工作流中的无依据说法与缺失分支并修复
  • 按任务或可视化 ID 取回已保存的规格、SVG 布局与 Mermaid 图
  • 通过邮箱一次性验证码或旧版密码登录以获取令牌
适用场景
当你已有经过审阅的书面流程、事故手册或政策，希望得到可编辑、可导出且有引用依据的流程图，而不是手绘示意图时适用。也适合用来核对图中的步骤是否确实有原文支撑。
运行要求
可通过 unseendocs.in 的 streamable HTTP 远程端点使用，或用 Node.js 经 npx 在本地运行 npm 包。需要账号以获得额度，登录使用邮件一次性验证码或旧版密码。README 还列出本地包所需的 OPENROUTER_API_KEY 及可选的 TYPESAFE_API_KEY。
安装前请注意
登录工具会向指定邮箱发送一次性验证码，并返回需在后续调用中携带的 bearer 令牌，应视其为凭据。编译与增强会把文档文本发送到 Unseen 服务；本地包在设置 OPENROUTER_API_KEY 时还可能发送给 OpenRouter。新账号仅有有限的免费额度，使用可能计费。仅支持经过审阅的书面文本，不解析扫描件与图片。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Unseen Workflow Compiler，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.eyeinthesky6%2Funseen-workflow-compiler/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "unseen-workflow-compiler": {
      "type": "http",
      "url": "https://unseendocs.in/mcp"
    }
  }
}

README

Unseen MCP Server (unseen-mcp)

The official Model Context Protocol (MCP) server for Unseen (unseendocs.in).

Turn messy operational documents, standard operating procedures (SOPs), incident playbooks, spreadsheets, and business communications into faithful, source-grounded visual workflows directly inside Claude Desktop, Cursor, Zed, Windsurf, or any MCP-compatible agent.

Capabilities

The unseen-mcp server provides 3 primary tools:

  1. compile_workflow: Compiles raw text, SOPs, or multi-page documents into a structured, verifiable VisualSpec workflow graph, accompanied by production-ready SVG and Mermaid syntax.
    • Arguments: content (string, required), title (string, optional).
  2. revise_workflow: Applies focused revisions or node additions/modifications to an existing workflow graph while preserving citation integrity.
    • Arguments: visualSpec (object, required), instructions (string, required).
  3. get_workflow: Retrieves the full structured representation of an existing visual artifact by its ID.
    • Arguments: id (string, required).

1-Click Installation (Smithery)

If you use Smithery.ai:

bash
npx -y @smithery/cli install unseen-mcp --client claude

Or for Cursor:

bash
npx -y @smithery/cli install unseen-mcp --client cursor

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "unseen": {      "command": "npx",      "args": ["-y", "unseen-mcp"],      "env": {        "OPENROUTER_API_KEY": "sk-or-v1-your-openrouter-key",        "TYPESAFE_API_KEY": "your-optional-typesafe-key"      }    }  }}

Cursor IDE Configuration

In Cursor Settings -> Features -> MCP:

  1. Click + Add New MCP Server.
  2. Name: unseen
  3. Type: command
  4. Command: npx -y unseen-mcp
  5. Add environment variables:
    • OPENROUTER_API_KEY: Your OpenRouter API key

Environment Variables

VariableDescriptionRequired?
OPENROUTER_API_KEYOpenRouter API key for LLM-assisted document compilationRecommended for rich natural language compilation (falls back to deterministic heuristics if absent)
TYPESAFE_API_KEYTypeSafe API key for Jev semantic audits and missing branch recoveryOptional

Running Locally

To run the stdio server directly from the command line:

bash
npx -y unseen-mcp

Or build from source in the unseen repository:

bash
git clone https://github.com/eyeinthesky6/unseen.gitcd unseennpm installnpm run build:mcpnode dist-mcp/index.cjs

License

MIT © Unseen

来源：README.md，提交 b21ffb6

工具

9

compile_workflow

Compile Workflow Diagram

Turn supplied document evidence or raw operational text into a publication-ready workflow diagram with source references, clean vector SVG, Mermaid, Excalidraw scene, and interactive Studio deep link (`studioUrl`). INPUT SCOPE: Use reviewed written procedures only. Do not interpret scans, images, chart/diagram geometry or unlabeled arrows, and do not certify business procedures. Ask for reviewed written process text or source-backed clarification. HOW TO STRUCTURE TEXT INPUTS: Either pass `sources` (array of 1..60 verbatim chunks `{id, locator, excerpt}` where each excerpt is <= 2000 chars with exact numbers/actors/thresholds preserved) OR pass raw `text` and Unseen will automatically segment it into source chunks. EDITING GUIDANCE: For cosmetic/styling/annotation edits, edit the returned `<svg>` XML directly. For structural/topological edits (adding/removing nodes or rerouting branches), edit `spec` (VisualSpec JSON) and call `autofix_workflow` ($0 deterministic connector healing + fresh SVG/Mermaid/Excalidraw) or `revise_workflow`.

输入参数textjobIdsources必填userGoal必填authTokenrequestIdhostContextpriorAnswersdesiredOutputschemaVersion必填

revise_workflow

Revise Workflow Diagram

Apply explicit node label/role changes or node removal using node IDs, or request connector autofix. For other changes, including new steps or edges, edit the returned spec with confirmed source evidence and call autofix_workflow. Unsupported instructions return an error; this tool does not perform general natural-language rewrites.

输入参数spec必填authTokeninstruction必填additionalSources

autofix_workflow

Autofix & Re-Render Workflow ($0 Free)

Deterministic connector healing and full visual re-rendering ($0 compute cost, instant, unlimited). Rescues orphan nodes, heals broken or missing decision branches, recomputes deterministic orthogonal layout, and returns fresh `spec`, `svg`, `mermaid`, `excalidraw`, and `studioUrl`. Use this tool after making direct structural edits to `VisualSpec` JSON (`nodes` / `edges`), or when a user asks to autofix connectors.

输入参数spec必填authTokenorientation

enhance_workflow

AI Enhance Workflow (TypeSafe Jev Audit & Repair)

Bundled free semantic verification and repair powered by TypeSafe Jev. Audits the VisualSpec against its cited `sources[]` for unsupported claims, missing decision branches, and role accuracy, applies targeted repair if actionable issues are found, and returns the enhanced `spec`, `svg`, `mermaid`, `excalidraw`, `studioUrl`, and Jev quality metrics.

输入参数spec必填visualIdauthToken

detect_workflows

Detect Candidate Workflows in Document

Discover distinct operational workflows from multi-section documents or raw text before compiling. Returns candidate workflows (`id`, `title`, `description`, `sourceIds`) audited by TypeSafe Jev.

输入参数textsourcesauthToken

get_workflow

Get Compiled Workflow

Retrieve an existing VisualSpec workflow by jobId or visualId, returning the spec, SVG layout, and Mermaid diagram.

输入参数id必填authToken

auth_request_otp

Request Agent & Human Login OTP (Email + OTP)

Step 1 of Agent & Human Login (Email + OTP): Sends a 6-digit Login OTP (`UNSEEN_LOGIN_OTP`) to the user's email address. This is a passwordless Login OTP (NOT a password reset). Once called, the agent can either read the 6-digit `UNSEEN_LOGIN_OTP` directly from the user's email (when the user has granted email access) or ask the user in chat for the 6-digit code, then call `auth_verify_otp`.

输入参数email必填

auth_verify_otp

Verify Agent & Human Login OTP

Step 2 of Agent & Human Login (Email + OTP): Verifies the 6-digit Login OTP sent to `email` and returns `{ token: 'utok_...', user }` (30 free credits / 3 visuals per month on new accounts). Pass the returned `token` as `Authorization: Bearer <token>` or in the `authToken` argument of subsequent MCP tool calls.

输入参数otp必填email必填

auth_login

Sign In with Email + Password

Legacy sign-in for an existing password account. Account creation and password setup require verified browser sign-in. ChatGPT/Codex plugin connections use browser OAuth instead of this tool.

输入参数nameemail必填password必填register

版本历史

1
  1. v1.0.1最新Oct 22, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分