프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

PhotoS

제작자: Dongwu259버전 1.4.2i★ –i내 컴퓨터에서 실행
레지스트리 이름io.github.Dongwu259/photo-s

설치

개요

제작자가 쓴 설명(영어 원문)

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

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 내 컴퓨터에서 실행
  • 전송 방식: stdio
  • 카테고리: 디자인, 이미지 및 오디오

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

  • 기본 점검: 1개 중 1개 통과
  • 내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
  • 레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

  • PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

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

터미널에서 이 명령어를 실행하세요

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

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 9일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 Dongwu259 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

디자인, 이미지 및 오디오 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 2810개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 2810개 중 22%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 2810개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

PhotoS, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.4.2)은 3개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Figma Context MCP, Claude Real Video, Figma MCP Server

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Figma Context MCP

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

제작자: GLips널리 사용됨↓ 16.1만/주★ 1.6만5개월 전 업데이트

내 컴퓨터에서 실행

Claude Real Video

Let any LLM watch a video locally — and search everything it has ever watched.

제작자: HUANGCHIHHUNGLeo널리 사용됨↓ 1.1천/주★ 2.3천2개월 전 업데이트

내 컴퓨터에서 실행

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

제작자: figma널리 사용됨★ 2.2천13개월 전 업데이트

클라우드에서 실행✓ mcp.figma.com

제작자의 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。


✨ 功能特性

功能GUICLI说明
批量压缩✅✅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.mdAgent 契约:JSON 结构、退出码、REST、MCP
docs/PLUGINS.md插件系统:SCUNet 降噪、LUT、自己写插件
docs/GUI_CHANGES.mdGUI 行为与接口契约
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

PopNx에게 묻기