S3eidat Tools

S3eidat Tools MCP

免费的私密 S3eidat Tools，作为 AI 助手可使用的工具。 PDF、图像、文本、开发者杂务、计算器、二维码和文档制作工具，均由本地 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/

你可以这样提问

• “合并这三份 PDF，压缩结果并添加页码。”
• “把 ~/Desktop/receipts 中的所有照片合成一份 PDF。”
• “将这张图像调整为 1200 px 宽的 WebP，并移除 GPS 数据。”
• “格式化这份 JSON 并将其转换为 YAML。” · “这个 cron 表达式是什么意思？”
• “25 万贷款，利率 5.2%，期限 25 年，每月还款多少？” · “明天安曼的祈祷时间。”
• “为我的 Wi-Fi 生成一个二维码。” · “根据这些项目制作一份发票 PDF。”

安装

你需要 Node.js 20.19 或更高版本（建议使用 22+）。首次运行时会下载软件包；之后启动即可立即运行。

Claude Code

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

Claude Desktop

**一键安装：**从最新版本下载适用于你电脑的 .mcpb 文件，然后双击它（或将其拖到“设置” → “扩展”中）。文件已包含所有内容，因此甚至无需安装 Node.js。你可以在扩展设置中选择允许访问的文件夹和输出文件夹。

**或手动安装：**打开“设置” → “开发者” → “编辑配置”，然后将内容添加到 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（单个项目）：

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

VS Code（Copilot Agent 模式）

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）只能访问公共互联网中的服务；在这些应用中公开此服务会导致你的文件暴露，因此请改用桌面/命令行客户端。

选项

选项	功能
--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	使用 Streamable HTTP 而非 stdio 提供服务。
--list	列出所有工具并退出。

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

工具很多，上下文却很小？

完整列表包含约 140 个工具，其工具定义约占 65k 个 token。支持工具搜索的客户端（Claude Code）可以很好地处理这种情况。如果你的客户端有工具数量限制（Cursor、Windsurf），或者你使用的是小型模型，可以选择工具组（--groups pdf,image 约占 17k 个 token），或使用 --compact（约 600 个 token）：这样，模型就会通过三个元工具搜索工具、读取其输入并运行工具。

{ "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 Agent	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 Agent”分组中的少数工具（例如将网页抓取为 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 中创建一个文件，其默认导出为 src/registry.ts 中的 defineTool({...})（契约文档位于该文件顶部）。系统会自动发现该工具。在 test/ 中添加一个已知答案测试。发布说明：RELEASING.md。

许可证

MIT © Omar (s3eidat)