zjzmei-mcp

最美证件照 MCP 服务。让 WorkBuddy、Claude Code 等 MCP 客户端直接制作证件照，并使用换底色、改大小、变清晰、格式转换四个图片工具。

运行

需要 uv 和一个 MCP 访问密钥。

ZJZMEI_API_KEY=你的密钥 uvx zjzmei-mcp

也可以用 npm 包启动（内部调用 uvx）：npx -y zjzmei-mcp。

环境变量	说明
`ZJZMEI_API_KEY`	必填，MCP 访问密钥
`ZJZMEI_API_BASE`	可选，业务 API 根地址，默认 `https://zmapi.zjzmei.top/api/v1`

命令行参数：--transport stdio|http（默认 stdio）、--host（默认 127.0.0.1）、--port（默认 8765）、--api-base。

HTTP 模式（Streamable HTTP，地址 http://<host>:<port>/mcp）的端点本身没有鉴权，只适合本机或可信内网自用。该模式下不读取服务端本地文件，也不写入 saveDir。

客户端配置

{
  "mcpServers": {
    "zjzmei": {
      "command": "uvx",
      "args": ["zjzmei-mcp"],
      "env": { "ZJZMEI_API_KEY": "你的密钥" }
    }
  }
}

工具

工具	作用
`list_spec_categories`	规格分类
`search_specs`	按关键字/分类搜索规格（尺寸、DPI、文件大小、默认底色）
`get_spec`	规格详情与可选背景色
`list_background_colors`	标准底色字典
`upload_photo`	上传源图，返回可复用的 `assetId`
`make_id_photo`	按规格或像素尺寸制作证件照，可生成排版照
`get_id_photo_colors`	查询同一会话其他底色的生成状态
`get_id_photo_layouts`	查询各底色排版照预览
`change_background`	换底色
`resize_photo`	压缩到指定 KB 区间并写入 DPI
`enhance_photo`	变清晰（自然 / 高清）
`convert_format`	转换为 JPG / PNG / WEBP

图片入参可以是本地文件路径、http(s) 图片链接或 assetId，源图仅支持 JPG/PNG。返回的图片地址是短期地址；传 saveDir 可直接保存到本地。

开发

uv sync
uv run pytest
uv build

Metadata

Release files for zjzmei-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zjzmei-mcp 0.1.0
File	Size	Uploaded	Provenance	Actions
zjzmei_mcp-0.1.0.tar.gz	18.9 kB	Nov 10, 2026	Without provenance	Details for zjzmei_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zjzmei-mcp 0.1.0
File	Interpreter	ABI	Platform	Actions Reset
zjzmei_mcp-0.1.0-py3-none-any.whl 17.9 kB Nov 10, 2026 Without provenance	Python 3	none	any	Details for zjzmei_mcp-0.1.0-py3-none-any.whl

Total release size: 36.7 kB

Release files / zjzmei_mcp-0.1.0.tar.gz

Download URL	zjzmei_mcp-0.1.0.tar.gz
Size	18.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`31c3dac58cf670841860215025dc2fdfd52f1c09e7124e30af096b1c30d8c63c`
BLAKE2b-256 checksum How to use checksums	`704a719799cd45985093c3100dde1c91e38903b28a66cd7e88e73eec16f6985c`
Upload date	Nov 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / zjzmei_mcp-0.1.0-py3-none-any.whl

Download URL	zjzmei_mcp-0.1.0-py3-none-any.whl
Size	17.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9b185d64fcc2ff6d7ac1546f34c2314fdda4b1b1b64e602567e2c6a36e4776b5`
BLAKE2b-256 checksum How to use checksums	`0f74d314ff54abb78e643780c73baab6c0cedd9871d3290f832d90d886646ae1`
Upload date	Nov 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Security for zjzmei-mcp 0.1.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.