marsdawn を呼び出す三つの方法。
MarsDawn には自前の AI モデルがありません。Markdown を書くためではなく、レビューするために作られているので、どのエージェントやモデルがそのファイルを作ったかは関係ありません。エージェントやスクリプトが marsdawn を呼び出す方法は三つあり、どれも最終的に同じ export を実行します。
使っているツールが対応しているものを選んでください:無料の marsdawn CLI、プレーンな Markdown の skill ファイル、または marsdawn-mcp という MCP サーバーです。三つとも同じ marsdawn export を呼び出し、同じ JSON 結果を返します。
CLI
marsdawn export notes.md --json は、シェルコマンドを実行できるエージェントやスクリプトならどれからでも呼び出せます。構造上、モデルに依存しません。返されるすべてのフィールドはAI エージェント向け marsdawnに文書化されており、そこが JSON スキーマの正典で、以下の二つの経路もそこを参照します。
skill ファイル
シェルを直接呼び出すのではなく、プレーンな Markdown の指示を読むエージェント向け——現時点では Claude Code——には、marsdawn skill という1ファイルが、marsdawn のインストール、export の実行、結果の読み取りを教えます。プレーンな Markdown なので、指示ファイルを読み込む他のエージェントも同じファイルを使えます。
MCP サーバー
marsdawn-mcp は、別の、公開された、Apache-2.0 ライセンスの独立した repository です。export_markdown_to_pdf という1つのツールを持つ MCP サーバーで、marsdawn export --json をラップしています。MCP クライアントをそれに向ければ、ツール呼び出しは CLI と同じ JSON を返します。
- 入手方法:GitHub のリリースに添付された MCP Bundle(
marsdawn.mcpb)として、またはソースから stdio でサーバーを実行することで入手できます。 - Registry:まだ MCP Registry には登録されていません(現在のリリース:0.1.0)。registry 経由で見つかる前に、repository で現在の状況を確認してください。
- ホスティング:自分でホストするしかありません。marsdawn-mcp のホスティングサービスは存在せず、サーバーは marsdawn 自身の隣、あなた自身のマシン上で動きます。
- 動作要件:macOS、marsdawn 0.5.0 以降、そしてサーバーを実行するための Node.js 20 以降。
同じ export、三つの入り口
どの入り口から呼び出しても、内部の動作は変わりません。同じ書き出しエンジン、同じテーマと紙のサイズ、Mermaid 図の描画に失敗したときの同じ diagramErrors。このページではその契約内容を繰り返しません。AI エージェント向け marsdawnに完全な内容があります。
次に
- 完全な JSON スキーマとすべての終了コード:AI エージェント向け marsdawn。
- Claude Code などのエージェント向けの1ファイルの skill:marsdawn skill。
- 精簡な JSON 結果が、なぜエージェント自身の context にとって重要なのか:トークンを節約するレビュー方法。