MCP Server To Markdown

MCP Server To Markdown

English | 简体中文

Cloudflare AI サービスを活用して、さまざまなファイル形式を Markdown の説明に変換する強力な Model Context Protocol（MCP）サーバーです。このサーバーは、シームレスなファイル変換と説明生成のための標準化されたインターフェースを提供します。

主な機能

• Cloudflare AI サービスとのシームレスな統合
• 効率的な Markdown の説明生成
• 幅広いファイル形式への対応
• Cloudflare のネイティブな tomarkdown API との統合
• ユーザーフレンドリーな MCP インターフェース
• クロスプラットフォーム対応

対応ファイル形式

カテゴリ	ファイル拡張子
ドキュメント	.pdf
画像	.jpeg, .jpg, .png, .webp, .svg
Web コンテンツ	.html
データ	.xml, .csv
スプレッドシート	.xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers

システム要件

• Node.js 18 以降
• 有効な Cloudflare API Token
• 有効な Cloudflare Account ID

インストール

Smithery を使用したインストール

Smithery を使用して、Claude Desktop 向けの Markdown変換サーバーを自動的にインストールするには：

npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claude

手動インストール

npm を使用してグローバルにインストールします：

npm install -g mcp-server-to-markdown

MCP クライアントの設定

Cursor との連携

1. Cursor の設定に移動します
2. サイドバーから「MCP」を選択します
3. 「Add new global MCP server」を選択します
4. 次の設定を適用します：

   {
     "mcpServers": {
       "to-markdown": {
         "command": "mcp-server-to-markdown",
         "args": [
           "CLOUDFLARE_API_TOKEN": "your_api_token"
           "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
         ]
       }
     }
   }
   

Claude Desktop の設定

次の内容を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "to-markdown": {
      "command": "mcp-server-to-markdown",
      "args": [
            "CLOUDFLARE_API_TOKEN": "your_api_token"
            "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
          ]
    }
  }
}

ChatWise の設定

1. ChatWise を起動します
2. 設定を開きます
3. Tools セクションを選択します
4. 「+」をクリックして新しいツールを追加します
5. 次のパラメーターを設定します：
   • 種類：stdio
   • ID：to-markdown
   • コマンド：mcp-server-to-markdown
   • 引数：

     CLOUDFLARE_API_TOKEN=your_api_token
     CLOUDFLARE_ACCOUNT_ID=your_account_id
     

API リファレンス

to-markdown ツール

さまざまなファイル形式を Markdown の説明に変換します。

入力パラメーター：

• filePaths：Array（必須）- 処理するファイルパスの一覧

レスポンスの構造：

[
  {
    "filename": "example.pdf",
    "mimeType": "application/pdf",
    "description": "Generated Markdown description",
    "tokens": 123
  }
]

開発ガイド

はじめに

1. クローンして環境をセットアップします：

git clone <repository-url>
cd mcp-server-to-markdown
cp .env.example .env

2. Cloudflare の認証情報を設定します：

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

3. 依存関係をインストールしてビルドします：

npm install
npm run build

プロジェクト構成

.
├── src/             # Source code
├── dist/            # Compiled output
├── types.ts         # Type definitions
└── .env             # Environment configuration

利用可能なスクリプト

• npm run build - TypeScript コードをビルドします
• npm run inspect - MCP inspector を実行します

使用例

const result = await toMarkdown({
  filePaths: [
    "/path/to/document.pdf",
    "/path/to/image.jpg"
  ]
});

ライセンス

MIT License

このプロジェクトは Frad LEE がメンテナンスしています。