概要
Web2MD MCP サーバーは、AI モデルを外部ツールやデータソースに接続するためのオープン標準である Model Context Protocol (MCP) を使って、AI アシスタントが直接呼び出せるツール群として Web2MD を公開します。 設定が完了すると、Claude、Cursor、Windsurf との会話を離れることなく、ページの変換、変換履歴の検索、保存済み Markdown の取得を依頼できます。MCP サーバーには Web2MD API キー(PRO プラン)が必要です。ダッシュボードから生成してください。
利用可能なツール
MCP サーバーは 3 つのツールを提供します。convert_url
URL を取得し、ページ内容を Markdown として返します。REST API と同じ変換オプションに対応しています。 プロンプト例: “Convert this URL to markdown: https://docs.example.com/getting-started”semantic_search
自然言語クエリを使って、これまでに保存したすべての変換を横断検索します。タイトル、URL、関連度スコア付きのマッチした変換のリストを返します。 プロンプト例: “Search my saved pages for articles about database indexing”get_conversion
指定した ID の保存済み変換の Markdown 全文を取得します。semantic_search で見つけた後、ドキュメント全体をコンテキストに取り込むのに便利です。
プロンプト例: “Get the full content of conversion abc123”
セットアップ
- Claude Desktop
- Cursor
- Windsurf
Claude Desktop の設定ファイルを開きます:Claude Desktop を再起動します。ツールピッカーに Web2MD のツールが表示されるはずです。
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
mcpServers の下に web2md エントリを追加します:使用例
MCP サーバーが起動したら、AI アシスタントに自然言語で依頼できます。ページを Markdown に変換する
ページを Markdown に変換する
あなた: Convert this URL to markdown: https://react.dev/learn/thinking-in-reactアシスタント: (
convert_url を呼び出し) 「Thinking in React」の変換済み Markdown はこちらです…保存済みの変換を検索する
保存済みの変換を検索する
あなた: Search my saved pages for anything about authenticationアシスタント: (
semantic_search を呼び出し) 認証に関連する保存済み変換が 3 件見つかりました:- “OAuth 2.0 Guide” — 2 日前に保存
- “JWT Best Practices” — 先週保存
- …
変換の全文を取得する
変換の全文を取得する
あなた: Get the full content of conversion abc123アシスタント: (
get_conversion を呼び出し) Markdown の全文はこちらです…トラブルシューティング
セットアップ後にツールが表示されない
セットアップ後にツールが表示されない
設定ファイルを編集した後、アプリケーションを再起動したか確認してください。ターミナルで
npx web2md-mcp が正常に実行できるかも確認してください。認証エラー
認証エラー
WEB2MD_API_KEY が正しいこと、PRO サブスクリプションが有効であることを再確認してください。キーは API キーページで確認できます。npx がパッケージを解決できない
npx がパッケージを解決できない
まずパッケージをグローバルにインストールしてみてください:
npm install -g web2md-mcp。その後、command を web2md-mcp に変更し、args フィールドを削除します。