ezmd について
ezmd-mcp は、ファイル、URL、貼り付けたテキストを LLM ワークフロー向けのページ分割 Markdown に変換します。引用用のセクション ID とページ表示を保ち、ページの除外、表の切り詰め、プロンプトインジェクションの疑いなどを報告します。
主な機能
- 01ファイル、URL、テキストの Markdown 変換
- 02トークン予算に応じたページ分割
- 03セクション ID とページ表示の付与
- 04変換時の警告の報告
- 05ジョブ結果のリソース公開
活用シーン
- 01Web ページの LLM 分析用の準備
- 02引用用のローカル文書変換
- 03変換内容に含まれる警告の確認
MCP 対応
URL、ファイル、テキスト変換、ジョブのページ取得、機能一覧の MCP ツールを提供します。完全な Markdown と sidecar JSON をリソースとして公開し、出典確認を促すプロンプトも備えています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx ezmd-mcpEZMD_PROFILEDefault output profile: full, compact, rag or agentEZMD_MCP_ALLOWED_DIRSDirectories convert_file may read, separated by the OS path separator (default: working directory)EZMD_REMOTEBase URL of an ezmd instance; converts there instead of in-processEZMD_API_KEYシークレットAPI key for EZMD_REMOTE, sent as X-API-Keyローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
5掲載時のツール一覧 · 5 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | |
| options | any | いいえ | |
| profile | any | いいえ | |
| max_tokens | any | いいえ |
詳細
ezmd-mcp
ezmd 用の MCP サーバーです。Claude Desktop、Claude Code、Cursor、VS Code、その他あらゆる MCP クライアントから、ファイル、URL、貼り付けたテキストを LLM 向けの Markdown に変換できます。結果はトークン予算に合わせてページ分割され、引用用のセクション ID とページマーカーが付与されます。また、警告(ページのスキップ、表の切り詰め、プロンプトインジェクションの疑い)もすべて報告し、コンテンツが黙って破棄されることはありません。
uvx ezmd-mcp # stdio, converts in-process
uvx ezmd-mcp --allowed-dirs ~/docs
uvx ezmd-mcp --remote https://ezmd.example # forward to an instance; EZMD_API_KEY is sent as X-API-Key
uvx ezmd-mcp --transport http --port 8765 # streamable HTTP on 127.0.0.1, bearer token required
ツール
| ツール | 機能 |
|---|---|
convert_url(url, profile?, max_tokens?, options?) | SSRF ガードを通じて http(s) URL を取得し、変換します。 |
convert_file(path? | data_url?, profile?, max_tokens?, options?) | 許可されたディレクトリ内のローカルファイル、または 1 MB 未満の base64 data: URL を変換します。 |
convert_text(text, source_hint?, profile?, max_tokens?) | 貼り付けたテキスト、HTML、Markdown、CSV、JSON を変換します。 |
get_job(job_id, cursor?, max_tokens?, profile?) | ジョブの状態、または cursor にあるページを取得します。すべての変換ツールで使うページネーションのエンドポイントです。 |
list_capabilities() | 対応形式、不足している追加機能、制限、取得が許可されているかどうかを返します。 |
すべての結果には job_id, title, source, tokens_total, pages_total, page, next_cursor, warnings, frontmatter, content が含まれます(1 ページ目には sections も含まれます)。デフォルトのプロファイルは agent(信頼できないコンテンツの囲い込み、セクション ID)です。max_tokens のデフォルトは 8000 で、上限は 50000 です。リソース ezmd://jobs/{id} と ezmd://jobs/{id}/sidecar では、完全な Markdown と sidecar JSON を参照できます。プロンプト summarize_with_provenance は、モデルにセクション ID とページを引用するよう求めます。
クライアントの設定、セキュリティに関する注意事項、すべてのオプションについては、docs/mcp.md を参照してください。Apache-2.0。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。