PhotoS

Name: PhotoS
Author: Dongwu259

作者：Dongwu259バージョン 1.4.2i★ 0iパソコンで動く

レジストリ名io.github.Dongwu259/photo-s

インストール方法

What it does

Batch photo processing: compress, convert, EXIF, rename, dedup, cull, galleries

Connects パソコンで動く
Account or key No key needed
Category デザイン・画像・音声

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 3/3 合格 · あなたのパソコンで動きます

まず：どの AI を使っていますか？

ClaudeWeb · アプリ · スマホChatGPTWebClaude CodeターミナルCursorコードエディタVS Codeコードエディタその他その他のアプリ

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません

Python (uv) を入れる
1 回だけ。Python (uv) が必要なすべてのサーバーで使えます
Python (uv) のダウンロードページを開く ↗
完了
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
完了

この設定を貼り付けて保存

{
  "mcpServers": {
    "photo-s": {
      "command": "uvx",
      "args": [
        "photo-s-tools",
        "mcp"
      ]
    }
  }
}

完了

Claude を終了してもう一度開く
完了
試してみる
PhotoS を使って、私に何ができるか教えて、1 つやってみせて
✓ Claude が PhotoS を使っていると言うか、回答に PhotoS のツール名が出れば接続成功です

メニュー名は 2026年11月11日に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ PhotoS につなげません

PhotoS はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · PhotoS につなげるアプリを使う

Claude の手順 →先にパソコンへ Python (uv) を入れてください（1 回だけ） · パソコン版 Claude アプリ（Windows または Mac）のみ。Web やスマホでは使えません
Claude Code の手順 →先にパソコンへ Python (uv) を入れてください（1 回だけ）
Cursor の手順 →先にパソコンへ Python (uv) を入れてください（1 回だけ）
VS Code の手順 →先にパソコンへ Python (uv) を入れてください（1 回だけ）

B · デザイン・画像・音声の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Pascal 3D Editor✓ ChatGPT
Semiotic✓ ChatGPT
TypeUI✓ ChatGPT

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください（1 回だけ）

Python (uv) を入れる
1 回だけ。Python (uv) が必要なすべてのサーバーで使えます
Python (uv) のダウンロードページを開く ↗
完了
ターミナルを開く
Mac：Command+スペースで Terminal と入力 · Windows：PowerShell を開く
完了

このコマンドを貼り付けて Enter

claude mcp add --scope user photo-s -- uvx photo-s-tools mcp

完了

Claude Code で /mcp と入力
PhotoS が一覧にあり、接続済みと表示されれば OK です
完了
試してみる
PhotoS を使って、私に何ができるか教えて、1 つやってみせて
✓ Claude Code が PhotoS を使っていると言うか、回答に PhotoS のツール名が出れば接続成功です

メニュー名は 2026年11月11日に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください（1 回だけ）

Python (uv) を入れる
1 回だけ。Python (uv) が必要なすべてのサーバーで使えます
Python (uv) のダウンロードページを開く ↗
完了
このボタンで Cursor を開く
Cursor で開く
Cursor がインストールの確認をするので Install を押します
完了
Cursor の AI チャットを Agent モードで開く
完了
試してみる
PhotoS を使って、私に何ができるか教えて、1 つやってみせて
✓ Cursor が PhotoS を使っていると言うか、回答に PhotoS のツール名が出れば接続成功です

メニュー名は 2026年11月11日に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください（1 回だけ）

Python (uv) を入れる
1 回だけ。Python (uv) が必要なすべてのサーバーで使えます
Python (uv) のダウンロードページを開く ↗
完了
このボタンで VS Code を開く
VS Code で開く
VS Code がインストールの確認をするので Install を押します
完了
VS Code の AI チャットを Agent モードで開く
完了
試してみる
PhotoS を使って、私に何ができるか教えて、1 つやってみせて
✓ VS Code が PhotoS を使っていると言うか、回答に PhotoS のツール名が出れば接続成功です

メニュー名は 2026年11月11日に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら？PhotoS を使っている人に聞いてみましょう💬 ディスカッション →

開発者向け：ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user photo-s -- uvx photo-s-tools mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "photo-s": {
      "command": "uvx",
      "args": [
        "photo-s-tools",
        "mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "photo-s": {
      "command": "uvx",
      "args": [
        "photo-s-tools",
        "mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "photo-s": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "photo-s-tools",
        "mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスター i: 0
週あたりのダウンロードi: 37/週
ライセンス i: MIT
接続方法: パソコンで動く
トランスポート: stdio
最新バージョンi: 1.4.2
カテゴリi: デザイン・画像・音声
レジストリ公開日i: 2026年8月15日
コードの最終更新i: 2026年9月18日
作者: Dongwu259
パッケージ: pypi: photo-s-tools
リポジトリ: Dongwu259/photo_s
レジストリでの状態: 有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月12日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Dongwu259 で確認済みです
✓ 合格
今もメンテナンスされている
コードの最終更新：2 か月前
✓ 合格
ライセンスがある
MITを使用
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

Google でログインして投稿

ユーザーレビュー

まだレビューはありません

Google でログインしてレビューを書く

デザイン・画像・音声のほかのサーバーとの比較i

このカテゴリのほかの2972件のうち0%よりスターが多い
このカテゴリのほかの2972件のうち21%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2972件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

PhotoSは安全ですか？

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は2 か月前、最新バージョン（1.4.2）がレジストリに届いたのは3 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：Figma Context MCP, AutoClip, Next AI Draw.io

同じカテゴリのほかの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

作者：GLips広く使われている↓ 15.2万/週★ 1.6万5 か月前更新

パソコンで動く

インストール

AutoClip

Clip long videos into short clips with covers and captions. Local CLI and MCP.

作者：zhouxiaoka広く使われている↓ 205/週★ 1万15 日前更新

パソコンで動く

インストール

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

作者：DayuanJiang広く使われている↓ 2.2万/週★ 3.7万リポジトリ全体のスター5 日前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

📷 PhotoS

CLI 给 AI agent 用，GUI 给人用。 PhotoS 是一个跨平台批量照片处理工具箱：给摄影师一套完整的 Tkinter GUI（图库 / 修图（真实管线实时预览 + 直方图 + 旁侧调整工具 + 照片间复制粘贴设置 + 逐照片撤销 + AI 调色 + 蒙版画布 + XMP 写回/载入，LR 双向往返）/ 导出（照片队列 + 输出设置 + 命名导出配方 + 调色配方随输出写 XMP）/ 工具四大模块，含审查打分灯箱、去重查看器、autopilot 智能监视），给 AI agent 一套带统一版本化 JSON 契约的 CLI / REST / MCP 接口。

🖥 GUI 给人用 — ⌨️ CLI 给 AI agent 用 — pip install photo-s-tools

中文 · English

🤖 为 AI agent 而生

PhotoS 首先是一个 AI agent 就绪的图像管线：四条集成通道，全部挂在同一个版本化 JSON 契约上（schema_version，加性演进——升级永不破坏消费者）。

通道	接入方式
MCP server — 31 核心工具 + 插件自动注册（process / suggest / autopilot / index / find / select / hdr / blurfaces / dedup …）	`claude mcp add photo-s -- photo-s mcp`
现成 SKILL.md — 支持 skill 的 agent 即取即用，零额外依赖	`cp -r skills/photo-s ~/.claude/skills/`
REST API — 异步任务 + SSE 进度	`photo-s serve --port 0 --token auto --ready-file x.json`
Python 库直调 — 无 IPC 开销	`from photo_s.engine import batch_process`

所有输出带 schema_version；JSON 键永远英文；单文件错误不中断整批；破坏性操作必须显式传参。完整契约见 docs/AGENT_API.md。

✨ 功能特性

功能	GUI	CLI	说明
批量压缩	✅	✅	JPEG/WebP/HEIC/AVIF 质量调优、色度子采样（444/422/420）
目标体积模式	✅	✅	自动调优质量以控制在目标文件体积以内
格式转换	✅	✅	JPEG / PNG / WebP / TIFF / BMP / HEIC / AVIF
RAW 解码	✅	✅	22+ 种相机 RAW 格式，内置支持（rawpy/libraw）；去马赛克算法可选、色彩空间（sRGB/AdobeRGB/ProPhotoRGB）、16-bit TIFF 输出、自动打 sRGB ICC
缩放 / 比例	✅	✅	最大尺寸、百分比或最长边上限
视觉预览	✅	—	原图↔处理后实时并排预览（经真实管线渲染，v2.4 含逐照片调整注入）
影调与色彩	✅	✅	亮度/对比度/饱和度/伽马/锐化，黑白、复古
导出锐化	✅	✅	LR 式输出级 USM，半径随输出分辨率缩放
白平衡	✅	✅	色温 K，或灰卡采样
WB tint 轴	✅	✅	绿(-)/品红(+) G-M 轴
点曲线 / 色阶	✅	✅	PCHIP 点曲线，手动黑/白场/伽马
三向颜色分级	✅	✅	阴影/中间调/高光色相 + 饱和分区
HSL 分色	✅	✅	8 色域，色相/饱和/亮度偏移
点颜色	✅	✅	取样色定向色相/饱和/亮度 + 范围容差
局部蒙版	✅	✅	命名线性/径向/颜色范围蒙版，蒙版内 11 项局部调整
镜头矫正	✅	✅	手动畸变 k1 / 去暗角 / 消色差（纯 numpy）；用户维护的命名镜头档案
感知分析	✅	✅	直方图/通道统计/色温倾向/曝光/模糊（`analyze`）
参数推荐	—	✅	规则型 `suggest`：分析统计 → 保守修复参数 + 理由（零模型离线）
自然饱和度 / 清晰度 / 纹理	✅	✅	反向加权饱和，局部对比
去雾 / 暗角 / 颗粒	✅	✅	暗通道去雾，径向暗角，胶片颗粒
曝光	✅	✅	曝光档位调整，或自动归一化到目标
自动色阶	✅	✅	2% 裁切直方图拉伸
高光恢复	✅	✅	LR 式：压缩硬切高光，恢复出渐变细节
LOG 还原	✅	✅	SLOG3/CLOG3/LOGC3/DLOG/VLOG/HLG（1D LUT，零依赖）
LUT 调色	✅	✅	.cube 三线性（插件加四面体 + 5 个电影预设）
降噪	✅	✅¹	NLM（`[enhance]` 可选依赖）
自动扶正	✅	✅¹	校正地平线，置信度门控（`[enhance]` 可选依赖）
HDR 合并	✅	✅¹	曝光融合，手持对齐（`[enhance]` 可选依赖）
人脸模糊	✅	✅¹	模糊或马赛克人脸，Haar cascade（`[enhance]` 可选依赖）
抠图 / 背景移除	✅	✅	AI 分割（`subject`/`person`/`object:类别`）或颜色键控（`color:R,G,B[tol,feather,invert]`——白底文字/logo 专用）→ alpha 透明输出，PNG/WebP/TIFF/AVIF/HEIC（JPEG 按文件报错，绝不静默拍平）
裁剪 / 旋转 / 翻转 / 留边	✅	✅	统一比例裁剪 + 任意几何
打印尺寸	✅	✅	中心裁剪 + 指定 DPI 的精确打印像素
智能重命名	✅	✅	日期/相机/序号模板
自动整理归档	✅	✅	日期/相机子文件夹归类
水印	✅	✅	文字 + 图片水印，7 个位置
多尺寸输出	✅	✅	一份输入，N 份带标签输出
元数据打标	✅	✅	评分/关键词/标题批量打标（UserComment）
元数据筛选	✅	✅	按评分/关键词筛出照片
元数据导入	—	✅	从表格批量写入
选片（筛选）	✅	✅	曝光/清晰度筛选（GUI 仅保留符合项，可撤销）；`--score` 质量评分排序 + `--burst` 连拍组留最佳
选片归档（评分）	✅	✅	按评分分拣——精选/淘汰双阈值（≥4 精选、≤2 淘汰）
连拍选图	✅	✅	每组保留最清晰
校验和清单	✅	✅	SHA-256 归档完整性 + 校验
HTML 画廊	✅	✅	自包含 index.html + 缩略图
预设	✅	✅	保存/加载命名配置 + 内置 `lr-look`（LR 风格：S 曲线+自然饱和+导出锐化）
多配置批量	—	✅	一份输入，N 份输出配置
并行处理	✅	✅	多线程
JSON 输出	—	✅	供 AI agent 消费的机器可读输出
配置文件	—	✅	TOML 默认值
EXIF 编辑	—	✅	批量版权/作者/GPS
预设一键套用	—	✅	一键套用已存风格
EXIF 日期偏移	—	✅	时区/相机时钟修正
隐私清理	—	✅	移除 EXIF + ICC + GPS
同步日期	—	✅	输出 mtime ← EXIF 拍摄时间
文件夹监视	✅	✅	自动处理新文件（`[watch]` 可选依赖）
自动旋转	✅	✅	基于 EXIF Orientation
图片去重	✅	✅	感知哈希重复检测
质量指标	✅	✅	SSIM / 模糊分
CSV 报告	—	✅	逐文件统计
完整性检查	—	✅	损坏文件扫描

¹ 降噪 / 自动扶正 / HDR / 人脸模糊需要可选依赖：

pip install photo-s-tools[enhance]（opencv-python-headless）。

未安装时给出明确安装提示，不影响其余功能。

📦 安装

pip install photo-s-tools            # 核心——内置 RAW 解码（rawpy）

pip install "photo-s-tools[enhance]" # + opencv：人脸模糊 / HDR / 降噪 / 扶正 pip install "photo-s-tools[tiff16]" # + tifffile：16-bit RAW → TIFF 输出 pip install "photo-s-tools[mcp]" # + MCP server（Python 3.10+）

零安装（uvx）：uvx --from photo-s-tools photo-s --help · uvx --from "photo-s-tools[mcp]" photo-s mcp

🚀 快速上手

photo-s batch 'RAW/*.ARW' --format jpeg -o out/ -q 90   # 批量 RAW → JPEG

photo-s batch 'RAW/*.ARW' -o out/ -q 95 --jpeg-subsampling 444 \ --raw-demosaic amaze # 极致画质 RAW → JPEG photo-s batch 'RAW/*.ARW' -o out/ --preset lr-look # 内置 LR 风格出片 photo-s compress *.jpg --target-size 5MB -j 8 # 自动调优到 ≤5MB photo-s select ~/shoot/ -r --selects-dir 精选 --rejects-dir 淘汰 --dry-run photo-s hash ~/deliver/ -o manifest.csv --verify manifest.csv

photo-s --help 列出全部 39 个子命令。语言：--language en|zh|auto。

🧭 文档

文档	内容
`docs/FEATURES.md`	完整功能清单——39 个 CLI 命令、引擎管线
`docs/AGENT_API.md`	Agent 契约：JSON 结构、退出码、REST、MCP
`docs/PLUGINS.md`	插件系统：SCUNet 降噪、LUT、自己写插件
`docs/GUI_CHANGES.md`	GUI 行为与接口契约
`docs/ROADMAP.md`	版本路线（已发布至 v2.5.1，v2.6 进行中）
`docs/COMMERCIAL.md`	商用授权：双许可说明、边界判定表与 FAQ
`CHANGELOG.md`	逐版本更新日志（含官方插件）
`CONTRIBUTING.md`	贡献指南：开发循环、改动的硬性规则、PR 要求

命名：PyPI 发行名 `photo-s-tools`（原名 photo-s 被 PyPI 拦截）·

CLI 命令 photo-s · Python 包 photo_s · 品牌 PhotoS。

🤝 参与

Bug / 功能建议 → 提交 issue
使用问题 / 想法 → Discussions
安全漏洞 → 请勿公开，见 SECURITY.md（私密通道）
想提 PR → 先读 CONTRIBUTING.md；需要跑通 python3 -m pytest tests/ -q

⚠️ 限制与说明

PhotoS 是批量 / 交付导向管线，不是交互式编辑器——不做 RAW 域编辑。局部编辑是规格驱动的：命名蒙版（linear/radial/color/AI 分割/笔刷/组合算子）+ 蒙版内局部调整，全部以紧凑字符串建模，经 CLI/REST/MCP/preset 零胶水传递。

设备上推理，无云端。 降噪模型权重（SCUNet）首次使用时下载到本机；不上传任何数据。
许可（双许可）。 官方代码与多数官方模型权重（含 SCUNet 检查点）为 MIT—— 可自由商用。唯一例外：auto-tone 插件的模型权重为 CC-BY-NC 4.0（非商用，训练数据来自个人 Lightroom 修图记录）——个人与非商业用途永久免费，商业用途需购买授权：邮箱 <1634103640@qq.com> · dwphoto.top/message。边界判定与常见问题见 docs/COMMERCIAL.md。第三方插件与模型各自持有自己的许可；商用再分发前请自行核实。

📄 许可证

MIT

PhotoS

What it does

インストール

Python (uv) を入れる

パソコン版 Claude アプリの設定ファイルを開く

この設定を貼り付けて保存

Claude を終了してもう一度開く

試してみる

代わりにできること

Python (uv) を入れる

ターミナルを開く

このコマンドを貼り付けて Enter

Claude Code で /mcp と入力

試してみる

Python (uv) を入れる

このボタンで Cursor を開く

Cursor の AI チャットを Agent モードで開く

試してみる

Python (uv) を入れる

このボタンで VS Code を開く

VS Code の AI チャットを Agent モードで開く

試してみる

パソコンにインストール

ひと目でわかる

使えるアプリ

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

話し合い

ユーザーレビュー

デザイン・画像・音声のほかのサーバーとの比較i

よくある質問

同じカテゴリのほかの候補

Figma Context MCP

AutoClip

Next AI Draw.io

作者のREADME

📷 PhotoS

🤖 为 AI agent 而生

✨ 功能特性

📦 安装

🚀 快速上手

🧭 文档

🤝 参与

⚠️ 限制与说明

📄 许可证