mcpField
D
Docs MD — Markdown Share

Docs MD — Markdown Share

リモート
docs-md.comファイル・ストレージ34 日前に更新
リポジトリ公式サイト

Docs MD — Markdown Share について

Docs MD は、ブラウザー、AI アシスタント、スクリプトから Markdown 文書を公開リンクにするサービスです。リンクには有効期限を設定でき、編集トークンを使って共有内容の更新や削除もできます。

主な機能

  1. 01Markdown のリンク公開
  2. 02リンクの有効期限設定
  3. 03共有内容の更新と削除
  4. 04Mermaid 図とコードの描画
  5. 05目次の自動生成と raw エンドポイント

活用シーン

  1. 01実装計画のレビュー共有
  2. 02エージェント引き継ぎ文書の公開
  3. 03注釈付きアーキテクチャ図の共有

MCP 対応

リモート MCP サーバーは、`share_markdown`、`update_share`、`delete_share` ツールをクライアントに提供し、文書の公開、更新、削除を可能にします。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://docs-md.com/api/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

3
パラメーター型必須説明
expiryenumいいえリンクの有効期間(デフォルトは 30d、"never" は無期限)1d | 7d | 30d | never
contentstringはい共有する Markdown の内容です。
filenamestringいいえMarkdown ファイル名(任意)

詳細

Docs MD

Markdown を無料でオンライン共有できます。登録は不要です。 Markdown ファイルを貼り付けると、Mermaid 図、コードのシンタックスハイライトに対応したレンダリング済みリンクを作成できます。有効期限は1日、7日、30日、または無期限から選べます。ブラウザーから docs-md.com で、MCP サーバーを介して Cursor や Claude Code から、または REST API を使ってスクリプトから共有できます。共有 URL は公開されます。編集トークンを使えば、同じ URL のまま内容を更新または削除できます。

ダウンロード可能なドキュメント付きの実例:実装計画をレビュー用に共有する · エージェントの引き継ぎドキュメント · 注釈付きアーキテクチャ図 · アカウント不要の共有サービスの比較。

デモ:Claude Code から計画を共有する

claude mcp add --transport http md-share https://docs-md.com/api/mcp

次に、計画を開いた状態で、次のように指示します。

implementation-plan.md を有効期限7日で公開してください。閲覧リンクを教えてください。編集トークンはドキュメントに含めないでください。

アシスタントは share_markdown を呼び出し、レンダリング済み URL、raw URL、有効期限、および編集トークンを返します。後から「共有内容を新しい計画に更新して」と指示すると、update_share が呼び出され、同じリンクのまま内容が更新されます。

機能

  • 📝 すぐに共有 - Markdown を貼り付けると、共有リンクが作成されます
  • 👀 ライブプレビュー - 公開前に、記述とプレビューを並べて確認できます
  • ⏰ 柔軟な有効期限 - デフォルトは30日。1日、7日、または無期限も選べます
  • ✏️ 編集と削除 - 共有ごとに非公開の編集トークンが返されます
  • 🧜 Mermaid 図 - ```mermaid コードブロックを図としてレンダリングします
  • 📑 目次 - 長いドキュメントにはサイドバーの目次が自動生成されます
  • 🔗 Raw エンドポイントと API - GET /raw/:id、/api-docs で利用できる完全な REST API
  • 🔌 MCP 連携 - share_markdown、update_share、delete_share ツール
  • 📚 ガイドとツール - 概要、MCP とは、AI IDE ガイド、ユースケース、API ドキュメント、実例、21種類の無料 Markdown ツール
  • 🔐 安全なデフォルト設定 - 検証、ペイロード上限、レート制限、保護された運用エンドポイント

公開ページ

  • / - Markdown エディターとライブプレビュー
  • /about - 製品の概要
  • /what-is-mcp - MCP の解説
  • /ai-powered-ide - AI IDE ワークフローガイド
  • /use-cases - よくある使用パターン
  • /api-docs - REST API ドキュメント(GitHub Actions での公開手順を含む)
  • /github-action - 再利用可能な GitHub Action(uses: invisible-hand/share-markdown-action@v1。ソースは github.com/invisible-hand/share-markdown-action)
  • /llms.txt - AI クローラー向けの公開ページの機械可読インデックス
  • /share-implementation-plan、/agent-handoff-document、/share-architecture-diagram、/bug-report-template - サンプルドキュメント付きの手順ガイド(content/examples/*.md。/examples/<slug>/raw で提供)
  • /share-markdown-without-account - 登録不要の Markdown 共有サービスの比較
  • /tools - 無料の Markdown ツール、/guides - 構文ガイド
  • /sitemap.xml および /robots.txt

API

docs-md.com/api-docs を参照してください。概要:

  • POST /api/share — リクエスト本文 {content, filename?, expiry?}。expiry ∈ 1d|7d|30d|never。戻り値 {id, url, rawUrl, editToken, expiresAt}(expiresAt が 0 の場合は無期限)
  • PATCH /api/share/:id — ヘッダー x-edit-token、リクエスト本文 {content, filename?}
  • DELETE /api/share/:id — ヘッダー x-edit-token
  • GET /raw/:id — raw text/markdown

インデックス登録ポリシー:インデックス登録できるのは無期限の共有のみです。有効期限付きの共有は noindex を付けて提供されます(検索エンジンへのリクエストであり、保証ではありません)。リンクを知っている人は誰でも、すべての共有を閲覧できます。有効期限が切れると URL のページは削除されますが、ダウンロード済みのコピーを回収することはできません。

MCP Registry

公式 MCP Registry に com.docs-md/markdown-share として公開されています。リモートのストリーミング可能な HTTP サーバーは https://docs-md.com/api/mcp で、share_markdown、update_share、delete_share の各ツールを提供します。

AI エージェント向け

  • 1 行で実行:curl --data-binary @PLAN.md "https://docs-md.com/api/share?expiry=7d"

  • 共有されたファイルを Markdown として読み取る:https://docs-md.com/<id>.md

  • Claude Code プラグイン(MCP サーバー + スキル):

    /plugin install docs-md --marketplace invisible-hand/docs-md.com
    
  • その他すべて(すべての MCP クライアント、AGENTS.md のスニペット、OpenAPI):https://docs-md.com/agents

MCP のセットアップ

API キー不要のリモートストリーミング可能な HTTP サーバーです。エディターごとの設定(Cursor、Claude Code、VS Code、Windsurf、Zed)はdocs-md.com/ai-powered-ideにあります。Cursor の場合は、~/.cursor/mcp.jsonまたはプロジェクトの.cursor/mcp.jsonに設定します。

{
  "mcpServers": {
    "md-share": {
      "url": "https://docs-md.com/api/mcp"
    }
  }
}

Cursor を再起動してから、「この Markdown ファイルを 7 日間の有効期限で共有して」と指示します。

セキュリティ設定

本番環境では、以下の環境変数を設定します。

# API body limits
MAX_SHARE_REQUEST_BYTES=200000
MAX_MCP_REQUEST_BYTES=250000
MAX_MARKDOWN_CHARS=120000

# Rate limiting (per IP, per window)
RATE_LIMIT_WINDOW_MS=60000
RATE_LIMIT_SHARE_PER_WINDOW=20
RATE_LIMIT_MCP_PER_WINDOW=30

# Protected endpoints
CRON_SECRET=your-cleanup-secret
ADMIN_API_SECRET=your-admin-secret

# Optional CORS allowlist for MCP preflight
MCP_ALLOWED_ORIGINS=https://docs-md.com,http://localhost:3000

開発

# Install
npm install

# Run dev server
npm run dev

# Type check
npm run type-check

# Lint
npm run lint

# Build
npm run build

技術スタック

  • Next.js 16、TypeScript、Tailwind CSS
  • Neon Postgres + Vercel Blob
  • Model Context Protocol(MCP)
  • Zod によるリクエスト検証

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。