tooldash-mcp

ToolDash MCP

AI エージェント向けのオフライン PDF・テキストツールです。 MCP サーバーです。Claude Desktop、Cursor、VS Code など、あらゆる MCP クライアントで、PDF の結合、ページの抽出、文書の確認、テキストの整形をすべてローカルで行えます。

アップロード不要です。API キー不要です。アカウント不要です。ネットワークへの接続も一切ありません。PDF の処理は pdf-lib によってローカルで行われるため、機密契約書がノート PC の外に出ることはありません。

---

ツール

ツール	機能	ファイルを書き込みますか？
pdf_info	PDF のページ数、各ページの寸法、メタデータを取得します	いいえ
merge_pdfs	2 つ以上の PDF を指定した順序で 1 つに結合します	はい
extract_pdf_pages	ページの選択範囲（"1-3,7,10-12"）を新しい PDF にコピーします	はい
clean_text	空白をまとめ、不可視文字を削除し、句読点を正規化します。オプションで URL も削除できます	いいえ

ファイルを書き込む 2 つのツールは、overwrite: true を指定しない限り、既存のファイルを置き換えません。そのため、エージェントが呼び出しを再試行しても、文書が気付かないうちに失われることはありません。

要件

Node.js 20 以降。

インストール

インストール手順はありません。MCP クライアントが必要に応じて npx で実行します。サーバーをクライアントの設定に追加し、再起動してください。

Claude Desktop

claude_desktop_config.json を編集します。

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%\Claude\claude_desktop_config.json
• Linux — ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tooldash": {
      "command": "npx",
      "args": ["-y", "tooldash-mcp"]
    }
  }
}

Claude Desktop を再起動します。チャットボックスのツールアイコンからツールを利用できます。

Cursor

プロジェクト内に .cursor/mcp.json を作成します（すべてのプロジェクトで使う場合は ~/.cursor/mcp.json に作成します）。

{
  "mcpServers": {
    "tooldash": {
      "command": "npx",
      "args": ["-y", "tooldash-mcp"]
    }
  }
}

次に、Settings → MCP でサーバーを有効にします。

VS Code（GitHub Copilot エージェントモード）

.vscode/mcp.json を作成します。

{
  "servers": {
    "tooldash": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tooldash-mcp"]
    }
  }
}

クローンから実行する

git clone https://github.com/LassiB999/tooldash-mcp.git
cd tooldash-mcp
npm install
npm test

その後、npx の代わりに node /absolute/path/to/tooldash-mcp/server.js をクライアントに指定します。

パスには絶対パス、クライアントの作業ディレクトリからの相対パス、または ~ で始まるパスを指定できます。前後の引用符は取り除かれるため、"/home/you/file.pdf" のように引用符付きで貼り付けたパスも使用できます。

ファイルアクセスの制限

このサーバーは、ユーザーアカウントがアクセスできる場所であればどこでもファイルを読み書きします。アクセス先を 1 つのディレクトリに限定するには、TOOLDASH_MCP_ROOT を設定します。このディレクトリ外のパスは、明確なエラーとともに拒否されます。

{
  "mcpServers": {
    "tooldash": {
      "command": "npx",
      "args": ["-y", "tooldash-mcp"],
      "env": { "TOOLDASH_MCP_ROOT": "/home/you/Documents/pdfs" }
    }
  }
}

使用例

「この 2 つの PDF を結合して、結果をデスクトップに保存して」のように、アシスタントに自然な言葉で依頼すると、以下の呼び出しが組み立てられます。テスト用の生の JSON も掲載しています。

pdf_info

{ "path": "/home/you/Documents/report.pdf" }

report.pdf: 12 page(s), 248.3 KB. Title: "Q3 Report".

merge_pdfs

{
  "inputPaths": ["/home/you/Documents/cover.pdf", "/home/you/Documents/report.pdf"],
  "outputPath": "/home/you/Documents/final.pdf",
  "overwrite": false
}

extract_pdf_pages

ページ番号は 1 から始まります。順序は維持されるため、"3,1-2" と指定すると、最初に 3 ページ目が出力されます。降順の範囲（例："5-1"）を指定すると、そのページが逆順になります。

{
  "inputPath": "/home/you/Documents/report.pdf",
  "pages": "1-3,7,10-12",
  "outputPath": "/home/you/Documents/excerpt.pdf"
}

clean_text

{
  "text": "Hello   world  \r\n\r\n\r\n\r\nSecond   line   ",
  "collapseBlankLines": true,
  "normalizeQuotes": false,
  "removeUrls": false
}

removeUrls を指定すると、http/https の URL がすべて削除されます。サーバーはオフラインのため、リンクが有効か無効かを判別できません。そのふりもしません。

エラーへの対応

不正な入力に対しては、クラッシュするのではなく、モデルが対処できる読みやすいエラー結果を返します。ファイルが見つからない場合、パスワードで保護された PDF の場合、文書の最終ページを超えるページ番号が指定された場合、出力先のパスがすでに存在する場合は、それぞれ次に何をすべきかを示すメッセージが返されます。サーバーは動作を継続します。

診断情報は stderr のみに出力されます。stdout にはプロトコルフレーム以外は一切出力されません。何かが混入すればテストに失敗します。

開発

npm test                # 15 end-to-end tests: a real MCP client over stdio, on real PDFs
npm run inspect         # open the MCP Inspector against this server

ToolDash を活用

ToolDash は、PDF、テキスト、画像、色、開発者向け、計算ツールなどを備えた無料のブラウザベースのユーティリティ集です。ファイルをアップロードすることなく、すべてブラウザーのタブ内で動作します。このサーバーは、同じ考え方をエディターに取り入れています。

• tooldash.app — ツールコレクション全体
• PDF Factory — これらの PDF ツールが再現している、ブラウザー上の PDF スタジオ
• Al-Katib — アラビア語キーボードとライティングパッド

ライセンス

MIT