mdshare — Free Markdown Sharing with MCP

Name: mdshare — Free Markdown Sharing with MCP
Author: urbanmorph

本地服务

github.com/urbanmorph生产力83 天前更新

代码仓库

关于 mdshare — Free Markdown Sharing with MCP

mdshare 是 Markdown 分享与协作服务，提供编辑器、分级权限链接和行内评论。其 MCP 服务可直接上传本地 Markdown 文件，插件则将分享功能带入 VS Code、Obsidian 和支持的 AI 工具。

主要功能

01通过四种权限级别分享文档
02使用所见即所得编辑器编辑 Markdown
03添加并解决行内评论
04实时同步与在线状态协作
05通过 MCP 和编辑器插件分享本地文件

适用场景

01以查看或编辑权限分享笔记
02针对特定文本段落收集反馈
03实时协作编辑 Markdown 文档
04从兼容 MCP 的工具上传本地笔记

MCP 相关

MCP 服务通过 `npx mdshare-mcp` 运行，并直接读取磁盘上的 Markdown 文件进行上传。Claude Code 和 Cursor 插件也封装了该服务。

#markdown #collaboration #sharing #free #mcp #productivity

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y mdshare-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmdshare-mcp1.5.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
file_path	string	否	本地 Markdown 文件的绝对路径。对于任何已存储在磁盘上的文件，优先使用此参数——完全避免传输内联内容。
content	string	否	内联 Markdown 内容。仅用于在对话中编写的简短片段。对于磁盘上的文件，请改用 file_path。
share_permission	enum	否	返回给用户的分享链接权限级别。默认值 'comment'——接收者可以读取和评论。只读时使用 'view'，需要完整写入权限时使用 'edit'。view \| comment \| edit

详细介绍

mdshare

即时分享 Markdown。免费。无需登录。

mdshare.live | API 文档 | VS Code | Obsidian

mdshare 编辑器

快速开始

在 mdshare.live 粘贴 Markdown，从空白页面开始，或通过 curl 上传：

curl -X POST https://mdshare.live/api/documents \
  -H "Content-Type: text/markdown" \
  --data-binary @your-file.md

你会获得一个管理 URL。分享它，或生成具有不同权限的链接。

完整 API 文档

功能

四种权限级别 —— 管理、编辑、评论、查看，每种权限都有专属的可分享链接
所见即所得编辑器 —— 格式工具栏、表格、代码块、键盘快捷键
行内评论 —— 对特定文本添加评论、回复并解决评论
实时同步 —— WebSocket 协作、实时在线状态指示
链接管理 —— 即时撤销链接、可选的有效期、每份文档最多 50 个链接
VS Code 和 Obsidian 插件 —— 直接从编辑器分享 Markdown
API 和 MCP —— REST API + MCP 服务，适用于 Claude、ChatGPT、Gemini、Cursor 和 Windsurf

MCP 服务

npx mdshare-mcp

在任何兼容 MCP 的 AI 工具中说 “将 my-notes.md 上传到 mdshare”。MCP 服务直接从磁盘读取文件（不会通过对话来回传递内容），因此即使是大型 Markdown 文件也能快速处理。设置指南

Claude Code 插件

/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph

它将上面的 MCP 服务封装为一个技能——当你说 “分享这份 Markdown” 之类的话时，Claude 就会调用它。设置指南 · 源代码

Cursor 插件

已列入 Cursor Directory——在列表页面点击 “Add to Cursor”。它使用与 Claude Code 插件相同的 MCP 服务和技能。源代码

Obsidian 插件

已列入 Obsidian 社区插件目录——通过 Settings → Community Plugins → Browse → search "mdshare" 安装。在库中右键点击任意 .md 文件即可分享；管理 URL 会复制到剪贴板。源代码

技术栈

组件	技术
框架	Astro 5
UI	React（作为 Astro islands）
托管	Cloudflare Workers（原生）
数据库	Cloudflare D1（SQLite）
实时功能	Cloudflare Durable Objects（WebSocket）
编辑器	Tiptap + tiptap-markdown
样式	Tailwind CSS v4
CI/CD	GitHub Actions

本地开发

git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install

# Create a .dev.vars file with your Cloudflare API token
echo "CLOUDFLARE_API_TOKEN=your_token" > .dev.vars

# Apply local D1 migrations
npx wrangler d1 migrations apply mdshare-db --local

# Start dev server
npm run dev -- -p 3737

参与贡献

欢迎提交问题和 PR。对于重大更改，请先提交问题进行讨论。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。