What dependencies or runtime does mdshare require?
The MCP server runs on Node.js and is invoked via `npx`. The web app runs on Cloudflare Workers with D1 (SQLite) and Durable Objects for real-time sync.
mdshare — Free Markdown Sharing with MCP Server
@urbanmorph
基本情報
mdshare — Free Markdown Sharing with MCP Server について
Share and collaborate on local markdown files via shareable links
mdshare — Free Markdown Sharing with MCP Server の設定
以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。
{
"mcpServers": {
"mdshare": {
"command": "npx",
"args": [
"mdshare-mcp"
]
}
}
}mdshare — Free Markdown Sharing with MCP Server のツール
14Upload markdown to mdshare and receive a shareable link. The response contains a read/comment/edit share link (default permission: comment) that the user can share with others. The admin credential (full control) is stored locally in ~/.mdshare-mcp/documents.json and is NOT returned in this response — if the user explicitly asks to see or save the admin URL, call get_admin_url. PREFER file_path over content for files already on disk — reads directly from disk without transmitting content through this conversation, which is dramatically faster for files larger than ~1KB.
Read a markdown document from mdshare. Returns the content. If the document was uploaded via this MCP server, 'key' is optional — the admin key will be loaded from local storage. PREFER output_path over inline reading for large documents — writes directly to disk and returns a small summary, dramatically faster than echoing content through the conversation.
Update the content of an existing mdshare document (full replace). Requires edit or admin permission. If the document is in this MCP server's local store, 'key' is optional. PREFER file_path over content for files already on disk — reads directly from disk without transmitting content through this conversation. If both file_path and content are provided, file_path wins. For small edits to large documents, consider patch_document instead — keeps version history granular.
Apply find/replace operations to a document without rewriting the full content. More efficient than update_document for small edits to large documents. Each find string must be unique unless replace_all is set. If the document is in this MCP server's local store, 'key' is optional. PREFER file_path over operations for batches of operations stored in a JSON file on disk — bypasses inline transmission. If both file_path and operations are provided, file_path wins.
Generate a share link for a document with specific permissions. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
List all share links for a document, including status (active/revoked), permission, and label. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
Revoke a share link, making it permanently inactive. Use list_links first to find the token of the link to revoke. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
List all comments on a document, including replies and resolution status. If the document is in this MCP server's local store, 'key' is optional.
Post a comment on a document, optionally anchored to specific text. Can also reply to an existing comment. If the document is in this MCP server's local store, 'key' is optional.
Resolve or unresolve a comment. Requires edit or admin permission. Key must be provided explicitly because comments are addressed by comment_id — the MCP server can't look up the parent document.
Get the edit history of a document — who edited, when, and via what. If the document is in this MCP server's local store, 'key' is optional.
List documents you've previously uploaded via this MCP server on this machine. Returns document_id, title, share_url, share_permission, created_at, and expires_at for each — does NOT return the admin credential. Use this to help the user find and resume older documents without re-pasting admin URLs. Does NOT include documents created via the mdshare web UI or via direct API calls from other clients — only those created by this MCP server. Returns an empty array on a fresh install or after the local store has been cleared.
Retrieve the admin URL for a document previously uploaded via this MCP server. The admin URL grants full control and is equivalent to a password. ONLY call this tool when the user explicitly asks to see, save, or copy the admin URL — for example: 'give me the admin URL', 'save the admin link to my notes', 'what's the owner credential'. DO NOT call this as part of normal upload, share, or collaboration flows; the admin URL should never be surfaced to the user unless directly requested.
Register an mdshare admin URL you already have saved (in notes, chat history, emails, etc.) so it can be resumed without re-pasting the key every time. Takes an admin URL of the form https://mdshare.live/d/{id}?key=adm_..., verifies it against the live API, and stores it in ~/.mdshare-mcp/documents.json. Only accepts admin URLs (adm_ prefix) — view/comment/edit share links will be rejected. For bulk registration across many files, use the LLM's built-in file reading and search tools to find admin URLs, then call this tool once per URL found.
概要
What is mdshare?
mdshare is a free markdown sharing service with an MCP (Model Context Protocol) server that allows AI tools like Claude, ChatGPT, Gemini, Cursor, and Windsurf to upload markdown files directly from disk without echoing through the conversation. It is designed for developers and writers who want to share markdown instantly with no login required.
How to use mdshare?
Run npx mdshare-mcp in any MCP-compatible AI tool, then say "upload my-notes.md to mdshare". The MCP server reads files directly from disk. You can also use the REST API: curl -X POST https://mdshare.live/api/documents -H "Content-Type: text/markdown" --data-binary @your-file.md to get an admin URL. Plugins are available for VS Code, Obsidian, Claude Code, and Cursor.
Key features of mdshare
- Four permission levels (Admin, Edit, Comment, View) with shareable links
- WYSIWYG editor with tables, code blocks, and keyboard shortcuts
- Inline comments anchored to specific text with reply and resolve
- Real-time sync via WebSocket with live presence indicators
- Link management with instant revocation, optional expiry, and 50-link cap
- Plugins for VS Code, Obsidian, Claude Code, and Cursor
Use cases of mdshare
- Share markdown notes or documentation with different permission levels
- Collaborate in real-time on markdown documents with inline comments
- Upload markdown files from AI tools like Claude or ChatGPT via MCP
- Embed markdown sharing directly from VS Code or Obsidian editors
よくある質問
How does mdshare compare to other markdown sharing services?
mdshare is free, requires no login, and offers four permission levels, real-time collaboration, and dedicated MCP support for AI tools.
Where are my documents stored?
Documents are stored in Cloudflare D1 (SQLite) on Cloudflare Workers infrastructure.
What are the known limits of mdshare?
Documents have a 50-link cap per document. The service is free and hosted on Cloudflare.
Does mdshare support authentication or private sharing?
No login is required. Access control is managed through permission-specific links (Admin, Edit, Comment, View).
「その他」の他のコンテンツ
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
26.0K
Codelf
unbugA search tool helps dev to solve the naming things problem.
14.2K
コメント