jotview

io.github.jotbins由 GitHub 帳號 jotbins 發布v0.7.0更新於 Oct 29, 2026

Turn markdown and Mermaid diagrams into rendered jotbins.com links, and read them back.

已驗證Streamable HTTP可網頁執行效率與工作流檔案與儲存

概覽

AI 產生的概覽

把 Markdown、Mermaid 圖表和數學公式轉成可分享的 jotbins.com 渲染連結,並能從這類連結讀回 Markdown 原文。

可以做什麼
  • 把 Markdown 渲染成現成的 jotbins 連結,支援 Mermaid 圖表、數學公式、提示區塊和 emoji 短代碼
  • 讀取 jotbins 的 /d 連結、公開 /p 貼文或短連結背後的 Markdown,方便引用或修改
  • 本機伺服器可依路徑直接渲染本機 Markdown 檔案,不必貼上全文
  • 可選擇長文件是否上傳以縮短連結,或完全保留在 URL 中
適用情境
適合讓助理把筆記、報告或圖表交給你一個可讀、可分享的頁面,而不是一大段原始 Markdown;也適合貼上 jotbins 連結後請助理讀取、引用或改寫內容。
執行需求
遠端方式:使用託管的 Streamable HTTP 端點,無需登入。本機方式:需要 Node 18 或更新版本,透過 npx 執行,無需帳號或設定。渲染本機檔案時需在專案資料夾中啟動,或指定允許的資料夾。
安裝前請注意
超過 500 字元(MCP)或 2000 字元(命令列)的連結會上傳到短連結服務,文件正文會被儲存;短連結 30 天無人開啟即過期,除非設為永久。可用 never/raw 選項讓文件留在本機。讀取短連結會計為一次造訪並使其保持有效。遠端伺服器無法禁止上傳。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 jotview,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.jotbins%2Fjotview/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "jotview": {
      "type": "http",
      "url": "https://mcp.jotbins.com/mcp"
    }
  }
}

README

jotview

Turn a markdown file into a jotbins link that renders it.

bash
npx jotview notes.md# https://jotbins.com/d#z:U1bwSM3JyecCAA

Zero dependencies. No install, no account, no config.

How it works

The document is compressed and packed into the URL's fragment — the part after #. Fragments are never sent to a server, so for links 2000 characters or fewer nothing you write leaves your machine. Opening the link renders it entirely in the browser.

Usage

jotview <file>            mint a link from a filejotview                   read markdown from stdinjotview decode <url>      print the markdown behind a /d, /p or short linkjotview mcp [--raw]       run as an MCP server for AI agents
  --raw                   never shorten; always the full /d URL  --short                 always shorten, even when small  --keep                  make a shortened link permanent  --open                  open the link in your browser  --copy                  copy the link to your clipboard  --json                  print the result as one JSON line (see below)  --base-url <url>        override https://jotbins.com  -h, --help  -v, --version

Examples:

bash
jotview README.md --opencat notes.md | jotviewjotview notes.md | pbcopyLINK=$(jotview notes.md --raw)jotview decode https://surl.jotbins.com/abc123 > notes.md

decode accepts jotbins.com/d links (decoded locally), surl.jotbins.com short links (fetched; like a click, that keeps an active short link alive) and public jotbins.com/p pastes (fetched from jotbins; private pastes read as not found).

Shortening, and what it costs you

A document's link grows with the document — roughly half the markdown's size in characters. A 20 KB file produces an ~8,700-character URL, which Discord, X, and most chat clients will not accept.

So links over 2000 characters are shortened via surl.jotbins.com, and jotview tells you on stderr when that happens:

note: uploaded to jotbins to shorten (8768 → 30 chars). use --raw to keep it local.note: short link expires after 30 days unused. use --keep to keep it forever.

Shortening uploads your document. The fragment is the markdown, so storing the URL stores the text. Below the threshold nothing is uploaded and no network request is made at all. Use --raw to keep a long document local, accepting a URL too long to paste into most places.

Short links clean up after themselves. One nobody opens for 30 days is deleted, with a 60-day window to bring it back from its waiting page. Pass --keep to make it permanent from the start, or click Save link on the waiting page any time before then. Full /d links are never stored, so they never expire.

If the shortener is unreachable or rate-limited, jotview prints the full link and exits 0 — it never fails your pipeline over a shortening problem.

Use with AI agents (MCP)

jotview mcp is a stdio MCP server with two tools. With render_markdown an AI writes markdown — notes, a report, a Mermaid diagram — and gets back a jotbins link to hand you; with read_link it reads a jotbins link you share.

Claude Code

bash
claude mcp add jotview -- npx -y jotview mcp

Claude Desktop — download jotview.mcpb from the latest release and double-click it. Optionally pick a docs folder it may read files from.

Cursor and other clients — add to the MCP config:

json
{ "mcpServers": { "jotview": { "command": "npx", "args": ["-y", "jotview", "mcp"] } } }

Then just ask: "draw a diagram of our deploy flow and give me a jotbins link."

render_markdown takes content (the markdown), plus optional title (link text instead of the first heading), keep (make a short link permanent) and shorten ("auto", "always" or "never"). It returns a ready-made markdown link, [First heading](url), and a note on whether anything was uploaded. It never reads files — the AI passes text it already has.

Rendering files. The local server can also take a path instead of content, so the AI doesn't have to paste a whole file into the tool call. It reads only .md, .markdown, .mdx and .txt files, and only inside the folder the server runs in (Claude Code starts it in your project) or a folder you allow with --allow-dir:

bash
claude mcp add -s user jotview -- npx -y jotview mcp --allow-dir ~/notes

If the server runs in / or your home folder and no --allow-dir is given, path is switched off. The remote server never reads files.

read_link takes a url (a /d link, a public /p paste or a short link) and returns the markdown behind it, so you can paste a link and say "fix the typos and give me a new link." Links never change; an edit is a new link.

Uploads. Every character of a link costs tokens, so MCP shortens sooner than the CLI: links over 500 characters go through surl.jotbins.com, which uploads the document (short links expire after 30 days unused unless keep is set). To forbid uploads entirely, start the server with --raw:

bash
claude mcp add jotview -- npx -y jotview mcp --raw

Works with clients on any MCP revision from 2024-11-05 through 2026-07-28.

Remote server — no install

The same tool runs at https://mcp.jotbins.com/mcp (Streamable HTTP, no sign-in), for clients that can't run local commands.

  • claude.ai (web and mobile): Settings → Connectors → Add custom connector → paste https://mcp.jotbins.com/mcp.
  • Claude Code: claude mcp add -s user --transport http jotview https://mcp.jotbins.com/mcp

Same rules as the local server, except it can't forbid uploads: use shorten: "never" per call, or the local --raw server, to keep a document off surl.jotbins.com. Uploads are rate-limited per client; over the limit you still get the full link.

The Worker lives in worker/ and deploys with cd worker && npx wrangler deploy.

Output contract

stdout is the URL and nothing else. Notices, warnings, and errors go to stderr, so $(jotview x.md) and jotview x.md | pbcopy stay clean.

With --json, stdout is one JSON line instead, for scripts and CI:

json
{"url":"https://surl.jotbins.com/abc123","rawUrl":"https://jotbins.com/d#z:…","shortened":true,"permanent":false,"failure":null}

failure is the shortener's error when shortening was tried and failed (url is then the full link).

Exit codes: 0 success, 1 runtime error, 2 usage error.

Limits

Input is capped at 1 MB, matching what the /d renderer will open.

Requirements

Node 18 or newer.

Releasing

Releases run from GitHub Actions. On an up-to-date main:

bash
npm version minorgit push --follow-tags

npm version also updates manifest.json and server.json. The v* tag then tests, publishes to npm (trusted publishing, with provenance), attaches jotview.mcpb to a GitHub release, and updates the MCP Registry entry. Move the Unreleased notes in CHANGELOG.md under the new version first (commit that before npm version). The Worker deploys separately: cd worker && npx wrangler deploy.

If a release run fails partway, fix the cause and finish it with gh workflow run release.yml -f tag=vX.Y.Z — finished steps are skipped.

License

MIT

來源:README.md,提交 5e3c39f

工具

2

render_markdown

Render markdown with jotbins

Turn markdown (GitHub-flavored, with ```mermaid diagrams, $math$ / $$math$$, > [!NOTE] callouts and :emoji: shortcodes) into a link that renders it as a page on jotbins.com. Returns a ready-made markdown link to show the user. Small documents live entirely in the link; larger ones are uploaded to surl.jotbins.com for a short link that expires after 30 days unused unless keep is true.

輸入參數keeptitlecontent必填shorten

版本歷史

3
  1. v0.7.0最新Oct 29, 2026
  2. v0.5.2Oct 26, 2026
  3. v0.5.1Oct 25, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分