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 分