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 分