S3eidat Tools

S3eidat Tools MCP

無料でプライベートな S3eidat Tools を、AI アシスタントが使えるツールとして利用できます。 PDF、画像、テキスト、開発者向けの作業、計算、QR コード、文書の作成に対応し、ローカルの MCP サーバーから提供されます。お使いのマシン上で動作するため、ファイルが外部にアップロードされることはありません。 アカウントも API キーも不要で、テレメトリーもありません。

Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex、Gemini CLI、その他すべての MCP クライアントで利用できます。

npx -y s3eidat-tools-mcp

ドキュメントサイト：https://s3eidat.github.io/s3eidat-tools-mcp/ · ツールリファレンス：docs/tools.md · スキル：skills/

できること

• 「この 3 つの PDF を結合して、圧縮し、ページ番号を付けてください。」
• 「~/Desktop/receipts にある写真をすべて 1 つの PDF にしてください。」
• 「この画像の幅を 1200 px に変更して WebP にし、GPS データを削除してください。」
• 「この JSON を整形して YAML に変換してください。」 · 「この cron 式の意味を教えてください。」
• 「25 年間、金利 5.2% の 250,000 のローンの月々の返済額はいくらですか？」 · 「明日のアンマンの礼拝時間を教えてください。」
• 「Wi-Fi 用の QR コードを作ってください。」 · 「これらの品目の請求書 PDF を作ってください。」

インストール

Node.js 20.19 以降が必要です（22 以降を推奨）。初回起動時にパッケージがダウンロードされ、以降はすぐに起動します。

Claude Code

claude mcp add s3eidat -s user -- npx -y s3eidat-tools-mcp

Claude Desktop

ワンクリック： お使いのコンピューター用の .mcpb ファイルを 最新リリースからダウンロードし、ダブルクリックするか、Settings → Extensions にドラッグします。すべて同梱されているため、Node.js も不要です。拡張機能の設定で、アクセスを許可するフォルダーと出力フォルダーを選択できます。

手動で設定する場合： Settings → Developer → Edit Config を開き、claude_desktop_config.json に追加してから Claude を再起動します。

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

Windows で Claude が npx を見つけられない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "s3eidat-tools-mcp"] を使用してください。

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）：

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

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

code --add-mcp '{"name":"s3eidat","command":"npx","args":["-y","s3eidat-tools-mcp"]}'

または、ワークスペース内の .vscode/mcp.json：

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

Windsurf

~/.codeium/windsurf/mcp_config.json：

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

Codex CLI

codex mcp add s3eidat -- npx -y s3eidat-tools-mcp

Gemini CLI

~/.gemini/settings.json：

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

その他のクライアント（Streamable HTTP）

npx -y s3eidat-tools-mcp --http --port 8787

次に、クライアントの接続先を http://127.0.0.1:8787/mcp に設定します。--host を指定しない限り、サーバーはお使いのマシン上でのみ待ち受けます。 ホスト型チャットアプリ（ChatGPT、claude.ai）は、パブリックインターネット上のサーバーにしか接続できません。このサーバーを公開するとファイルも公開されるため、代わりにデスクトップクライアントまたは CLI クライアントを使用してください。

オプション

オプション	説明
--root <dir>	<dir> 内のファイルのみ読み取りと書き込みを許可します（共有マシンでの使用を推奨）。
--out-dir <dir>	ツール呼び出しで output パスが指定されていない場合の出力先です（デフォルト：一時フォルダー）。
--max-mb <n>	入力ファイルの最大サイズ（MB）です（デフォルト 200）。
--groups pdf,image	これらのグループのみを公開します：pdf、image、text、data、dev、calc、everyday、qr、docs、ai。
--compact	すべてのツールの代わりに、小型のメタツール 3 つ（s3eidat_find_tools、s3eidat_tool_info、s3eidat_run_tool）を公開します。
--only pdf_,image_	名前がこれらのプレフィックスで始まるツールのみを公開します。
--output-schemas	各ツールの出力 JSON Schema も提示します（いずれの場合も、結果には常に構造化 JSON が含まれます）。
--http、--port、--host	stdio の代わりに Streamable HTTP で提供します。
--list	すべてのツールを表示して終了します。

例："args": ["-y", "s3eidat-tools-mcp", "--root", "/Users/me/Documents"]。

ツールが多く、コンテキストが小さい場合は？

ツールの全リストは約140個で、ツール定義は約65kトークンになります。ツール検索機能を備えたクライアント（Claude Code）なら問題なく扱えます。クライアントにツール数の上限がある場合（Cursor、Windsurf）、または小型モデルを使う場合は、グループを選択する（--groups pdf,image で約17kトークン）か、--compact（約600トークン）を使用してください。するとモデルは3つのメタツールを通じてツールを検索し、入力を読み取って実行します。

{ "mcpServers": { "s3eidat": { "command": "npx", "args": ["-y", "s3eidat-tools-mcp", "--compact"] } } }

ファイルの仕組み

• 入力にはローカルパス（絶対パス、~/…、または--rootからの相対パス）か、base64（そのままの値、base64:…、またはdata: URI）を指定します。
• 出力は指定したoutput（ファイルパス、または末尾が/のフォルダー）か、出力フォルダーに書き込まれます。結果として返されるのはパスと簡単なメタデータであり、大きなbase64データではありません（バイトデータが必要な場合は、対応している箇所でreturnBase64を設定してください）。
• あるツールの結果のpathを次のツールに渡して、ツールを連携できます。例：pdf_from_images → pdf_compress → pdf_page_numbers。

ツール

162 個のツール。 全リファレンス：docs/tools.md。

グループ	数	ツール
PDF	17	pdf_compress, pdf_extract_pages, pdf_form_fields, pdf_form_fill, pdf_from_images, pdf_info, pdf_merge, pdf_metadata_read, pdf_metadata_write, pdf_organize, pdf_page_numbers, pdf_rotate, pdf_sign_image, pdf_split, pdf_to_images, pdf_to_text, pdf_watermark
画像	16	image_ascii_art, image_ascii_banner, image_compress, image_convert, image_crop, image_exif_read, image_exif_strip, image_favicon_set, image_from_base64, image_palette, image_placeholder, image_resize, image_rotate, image_svg_to_png, image_to_base64, image_watermark
テキスト	15	text_arabic, text_case, text_citation, text_clean, text_diff, text_escape, text_fancy, text_layout_fix, text_lorem, text_morse, text_number_to_words, text_readability, text_slugify, text_social_count, text_word_count
開発者向け：データ形式	15	css_format, csv_to_json, curl_to_code, html_format, json_format, json_query, json_to_csv, json_to_types, json_to_yaml, markdown_table, markdown_table_parse, sql_format, xml_format, xml_query, yaml_to_json
開発者向け：ユーティリティ	23	base_convert, base64_decode, base64_encode, bytes_convert, chmod_calc, cron_explain, css_clamp, css_units, gitignore_generate, hash_compute, http_status, id_generate, id_inspect, ip_in_range, jwt_decode, meta_tags_generate, regex_test, subnet_calc, time_convert, url_decode, url_encode, url_parse, useragent_parse
計算機	24	calc_age, calc_bmi, calc_cash_count, calc_compound_interest, calc_date_diff, calc_discount, calc_due_date, calc_equation, calc_expression, calc_fraction, calc_fuel_cost, calc_gpa, calc_hijri, calc_hours, calc_loan, calc_percentage, calc_primes, calc_roman, calc_salary, calc_sleep, calc_split_bill, calc_stats, calc_unit_convert, calc_zakat
日常・セキュリティ	15	crypto_file_decrypt, crypto_file_encrypt, crypto_stego_hide, crypto_stego_reveal, crypto_text_decrypt, crypto_text_encrypt, password_check, password_generate, prayer_times, qibla_direction, random_dice, random_pick, random_teams, secret_santa_draw, time_world_clock
QR・バーコード	4	barcode_generate, qr_generate, qr_read, qr_wifi
ドキュメント作成	7	doc_attendance_sheet, doc_business_cards, doc_calendar, doc_invoice, doc_labels, doc_receipt, doc_resume
AI エージェント向け	26	ai_chart, ai_chunk_text, ai_create_pptx, ai_create_xlsx, ai_csv_profile, ai_detect_language, ai_diagram, ai_docx_to_markdown, ai_extract_entities, ai_file_identify, ai_html_to_markdown, ai_image_diff, ai_json_schema_infer, ai_json_schema_validate, ai_markdown_to_docx, ai_markdown_to_pdf, ai_media_info, ai_ocr, ai_pdf_to_markdown, ai_pptx_to_markdown, ai_sql_query, ai_text_similarity, ai_token_count, ai_web_fetch, ai_xlsx_to_markdown, ai_zip

各ツールの説明には、視覚的なバージョンを使いたい人向けに、対応するウェブツールへのリンクがあります（https://s3eidat.github.io）。

スキル

skills/s3eidat-tools は、AI に各作業に適したツール、ツールの連携方法、ウェブツールを使う人を案内するタイミングを教えます。インストール手順：skills/README.md。

プライバシー

すべての処理は、お使いのマシン上の Node プロセス内でローカルに実行されます。ウェブサイトのポートからネットワークリクエストが送信されることはありません。「AI エージェント向け」グループの一部のツール（ウェブページを Markdown として取得するツールなど）はネットワークを使用します。これらのツールには openWorldHint が付いているため、クライアントは実行前に確認できます。分析、テレメトリー、アカウントはありません。

サポート

ツールは無料です。時間の節約に役立ったら、コーヒーをごちそうしてください ☕。PDF の読み取りや文章の作成、翻訳を行う AI をお探しですか？s3eidatGPTをお試しください。

開発

npm ci
npm test          # builds, runs known-answer tests for every tool and an MCP round trip
npm run docs      # regenerates docs/tools.md, docs/*.html, docs/llms.txt
npm run smoke     # drives the built server over MCP stdio
npm run mcpb      # builds a Claude Desktop extension for this platform into mcpb/out/
node dist/index.js --list
npx @modelcontextprotocol/inspector node dist/index.js

ツールを追加するには、src/tools/<group>/…/<slug>.ts にファイルを 1 つ作成し、src/registry.ts の defineTool({...}) をデフォルトエクスポートとして指定します（契約についてはファイルの先頭に記載されています）。ツールは自動的に検出されます。test/ に既知の答えを使ったテストを追加してください。リリースについては、RELEASING.mdをご覧ください。

ライセンス

MIT © Omar (s3eidat)