Claude と FreeTool をつなぐ|MCPサーバー
npmパッケージ freetool-mcp を入れるだけで、 Claude Desktop・Claude Code・CursorからFreeToolのPDF・テキスト・QRツールを直接呼び出せます。 ネイティブツールはあなたの端末上で実行され、 ファイルはローカルファイルパスで受け渡されます。サーバーには一切送信されません。
何ができる?
Claudeに普通に話しかけるだけで、FreeToolのツールがその場で動きます。具体例を6つ。
「このフォルダのPDFを全部1つに結合して」
pdf_merge を呼び出しClaudeがフォルダをスキャンしてPDFを順に結合し、指定パスに保存します。
「このCSVをJSONに変換して」
text_csv_to_json を呼び出しヘッダ行を自動検出してJSON配列に変換。結果はチャット内に表示されます。
「この長文の文字数・単語数・行数を数えて」
text_character_count を呼び出し文字数(半角/全角別)・バイト数・行数・単語数をまとめて返します。
「Wi-FiパスワードをQRコードにして印刷したい」
qr_generate を呼び出しSSID・パスワードからWPA形式のQRコードPNGを生成し、保存パスを返します。
「この契約書PDFにAES-256でパスワードをかけて」
pdf_lock を呼び出し印刷・コピー制限も含めて暗号化したPDFを生成し、ローカルに保存します。
「この論文PDFから本文テキストだけ抜き出して」
pdf_extract_text を呼び出し埋め込みテキストをページごとに抽出。Markdown形式でも返せます。
インストール手順
お使いのクライアントに合わせて、いずれかの手順をどうぞ。 Node.js(v18以降)が入っていれば追加のインストールは不要です。
Claude Desktop
- 設定ファイルを開くmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json - 次のJSONをマージ(既に
mcpServersがある場合はfreetoolエントリだけ追加)claude_desktop_config.json{ "mcpServers": { "freetool": { "command": "npx", "args": ["-y", "freetool-mcp"] } } } - Claude Desktop を完全に終了して再起動
- 入力欄の 🔌 アイコンに
freetoolが表示されていれば成功
Claude Code
ターミナルで以下を実行するだけです。
claude mcp add freetool --command "npx -y freetool-mcp"確認: 新しいセッションで /mcp を実行し、freetool がツール一覧に表示されたら成功。
Cursor
- Settings → MCP → 「Add new MCP server」 をクリック
- Type:
command - Command:
npx -y freetool-mcp - 保存して、ツール一覧に
freetoolが出れば成功
使えるツール一覧
ネイティブツール15種はあなたの端末上で実行されます。 画像・動画・音声の14ツールは、ブラウザWASMでしか動かない関係で FreeTool上の対応URLを返す「URL推薦」型です。詳細カテゴリは /for-ai にあります。
| カテゴリ | ツール名 | 種別 | 何ができるか |
|---|---|---|---|
pdf_merge | ネイティブ | 複数のPDFを1つに結合 | |
pdf_split | ネイティブ | PDFを指定範囲で分割 | |
pdf_rotate | ネイティブ | ページを90/180/270度回転 | |
pdf_page_numbers | ネイティブ | ページ番号を追加 | |
pdf_watermark | ネイティブ | テキスト透かしを追加 | |
pdf_lock | ネイティブ | AES-256 でパスワード保護 | |
pdf_unlock | ネイティブ | パスワード/制限解除(所有同意必須) | |
pdf_extract_text | ネイティブ | 埋め込みテキストを抽出 | |
| テキスト | text_character_count | ネイティブ | 文字数・バイト数・行数・単語数 |
| テキスト | text_json_format | ネイティブ | JSON整形 / minify |
| テキスト | text_csv_to_json | ネイティブ | CSV → JSON |
| テキスト | text_base64 | ネイティブ | Base64エンコード / デコード |
| テキスト | text_diff | ネイティブ | 2文書の差分(unified diff) |
| テキスト | text_remove_whitespace | ネイティブ | 余分な空白・改行の除去 |
| ユーティリティ | qr_generate | ネイティブ | QRコードのPNG / SVG生成 |
| 画像系(11ツール) | image_* | URL推薦 | freetool.jp/image/* のURLを返す(ブラウザWASMで処理) |
| 動画系(2ツール) | video_* | URL推薦 | freetool.jp/video/* のURLを返す(ブラウザWASMで処理) |
| 音声系(1ツール) | audio_transcribe | URL推薦 | freetool.jp/audio/transcribe のURLを返す(ブラウザでWhisper実行) |
プライバシー
ネイティブツールはあなたの端末上で実行されます。ファイルはローカルファイルパス経由で受け渡され、サーバーには一切送信されません。
URL推薦ツールが返すURLは、あなたがブラウザで開いた場合のみアクセスされます。 開いた先(freetool.jp の対応ページ)もブラウザ内で完結する WebAssembly 処理なので、 そこでもファイルはネットワークを流れません。
参考: 安全性について / プライバシーポリシー
よくある質問
無料ですか?
はい。MCPサーバー(freetool-mcp)もfreetool.jpも完全無料です。アカウント登録もありません。
npm のアカウントは必要?
不要です。`npx -y freetool-mcp` は実行時に最新版をダウンロードして起動するだけで、npmへのログインは要りません。
ファイルはどこに保存される?
各ツールに渡す `output_path` 引数で指定します。省略時は OS の一時ディレクトリ(macOS/Linuxは /tmp、Windowsは %TEMP%)に書き出します。ファイルがネットワークを経由することはありません。
Claude Code でも使える?
はい。ターミナルで `claude mcp add freetool --command "npx -y freetool-mcp"` を実行するだけで追加できます。
画像・動画・AI系のツールは使えますか?
ブラウザWASMでしか動作しないツール(画像11種・動画2種・音声1種)は、MCPからは対応するfreetool.jpのURLを返すだけです。実処理はブラウザで完結し、こちらもファイルは端末から外に出ません。
次のステップ
For English speakers
freetool-mcpis a Model Context Protocol server that lets Claude Desktop, Claude Code, and Cursor invoke FreeTool's PDF, text and QR tools directly. Native tools run on your machine — files are passed by local file path and never sent to a server. Image, video and audio tools (which need browser WebAssembly) return a freetool.jp URL instead. Free, no signup, MIT license. 15 native tools + 14 URL recommendations = 29 total.
Install for Claude Desktop
Merge into claude_desktop_config.json (macOS:~/Library/Application Support/Claude/ · Windows:%APPDATA%\Claude\):
{
"mcpServers": {
"freetool": {
"command": "npx",
"args": ["-y", "freetool-mcp"]
}
}
}Install for Claude Code
claude mcp add freetool --command "npx -y freetool-mcp"Privacy: native tools execute on your device. The MCP server reads and writes local files only. Nothing is uploaded.
Package: npmjs.com/package/freetool-mcp · Source: github.com/tatsuabe69/freetool