Gency Mcp

ai.gency由 gency.ai 发布v0.7.0更新于 Oct 29, 2026

Gency AI product image generation - MCP server for Claude, Codex, Cursor, VS Code

发布方自己的服务:Gency Lite

已验证STDIO仅桌面媒体与设计

概览

AI 生成的概览

通过本地 MCP 服务器让助手使用 Gency AI 服务生成产品图片。

可以做什么
Gency Mcp 是一个本地 stdio MCP 服务器,把助手连接到 Gency AI 产品图片生成服务。注册表描述称其面向 Claude、Codex、Cursor、VS Code 等助手提供产品图片生成。清单未列出具体工具,因此这里无法说明确切的可用操作。配置通过环境变量完成,涉及 Gency API 基础地址和 OAuth 设置。
适用场景
当你希望助手在不离开编辑器或聊天客户端的情况下通过 Gency 生成产品图片时,可以考虑使用。它适合桌面工作流,因为以本地进程运行且标注为仅限桌面。
运行要求
需要 Node.js 和 npm 包 @gency-ai/gency-mcp,以 stdio 方式在本地运行。环境变量包括 GENCY_API_URL、GENCY_OAUTH_API_BASE、GENCY_OAUTH_CLIENT_ID、GENCY_OAUTH_SCOPE、GENCY_MCP_ALLOWED_CLIENT_IDS 和 GENCY_MCP_OAUTH_RESOURCE。机密 GENCY_OAUTH_CLIENT_SECRET 仅在机密 OAuth 客户端时需要,GENCY_MCP_UPLOAD_SECRET 仅在多实例 HTTP 服务时需要。需要访问 Gency API 的网络连接。
安装前请注意
该服务器可能要求机密 GENCY_OAUTH_CLIENT_SECRET,多实例 HTTP 服务时还要求 GENCY_MCP_UPLOAD_SECRET;两者都应视为凭据,不要写入共享配置。图片生成可能消耗 Gency 付费额度,请先确认套餐与限额。生成的图片和提示词会发送给第三方 Gency 服务。清单未列出工具,授权前应先确认服务器实际能做什么。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gency Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

该仓库没有 README。

工具

21

login

Start OAuth login (opens a browser). Captures the callback in-process and stores tokens at ~/.gency/tokens.json. gency-mcp uses OAuth only — this is the single sign-in flow.

输入参数portscopeapi_baseclient_idclient_secrettimeout_seconds

logout

Remove stored OAuth tokens (~/.gency/tokens.json). gency-mcp is OAuth-only — there is no API key state to clear.

无需输入参数。

auth_status

Inspect current Gency OAuth state. Call this BEFORE the first gency tool in a session if unsure — output's 'Next action' line tells you whether to invoke `login` or proceed. gency-mcp authenticates with OAuth only.

无需输入参数。

get_team

Get current team information including team name and plan

无需输入参数。

list_workspaces

List all workspaces in the current team

无需输入参数。

create_workspace

Create a new workspace. Confirm with the user before executing.

输入参数name必填

update_workspace

Rename a workspace. Confirm with the user before executing.

输入参数name必填workspaceId必填

list_templates

List templates for a workspace (workspace-specific + defaults TEMPLATE_01~TEMPLATE_12). Present as a picklist for the user — do NOT silently pick.

输入参数productTypeworkspaceId必填

list_products

List products in a workspace.

输入参数workspaceId必填

get_product

Get detailed information about a specific product.

输入参数productId必填

create_product

Create AI-generated product images. **Consumes credits — confirm with the user first.** Only `category: "CLOTHING"` is accepted by the API today. Defaults to ONE product per request (all colors go in a single `colors` array; split only on explicit user request). **Do NOT guess colors/fabrics/features/laundryTips from filenames or category — ask the user.** Generation is asynchronous: poll `get_product` until status leaves CREATING. Read resource `gency://api-reference/products` for the full ProductMetadata schema (category enum, additionalInfo, sizeTables format).

输入参数products必填workspaceId必填

update_product_status

Change product review status. Confirm with the user. Transitions: BEFORE_REVIEW → IN_REVIEW → REVIEW_COMPLETE.

输入参数status必填productId必填

get_upload_url

Get a presigned S3 URL to upload one product image, plus the uploadHandle that `upload_image` requires. Single-use, valid 1h; uploaded images retained 24h. See `gency://api-reference/images`. Tip: for the common 6+ images case, prefer `prepare_product_images` (single call).

输入参数extension必填workspaceId必填

download_product_image

Render a generated product's detail page and save the resulting image locally. Requires the product to be generated (status past CREATING). Rendering is slow — allow up to 3 minutes.

输入参数productId必填outputPathtemplateId

upload_image

PUT a local image file to the presigned S3 URL that get_upload_url issued. Pass the `uploadHandle` from that call — it carries the destination URL, so no URL is accepted here.

输入参数filePath必填contentTypeuploadHandle必填

prepare_product_images

Upload 6+ local images for a workspace and return imageIds ready for create_product. Use this when the user gives you several image paths — it replaces 6× (get_upload_url + upload_image). Fails fast if fewer than 6 paths are supplied (Gency requires min 6 per product).

输入参数filePaths必填workspaceId必填

get_me

Get current authenticated user information

无需输入参数。

list_users

List all team members

无需输入参数。

get_user

Get information about a specific team member. The target user must belong to the same team as the caller.

输入参数userId必填

get_credits

Get remaining credit balance for the team. Call this BEFORE create_product to ensure sufficient credits.

无需输入参数。

search_docs

Search Gency API docs by keyword. Returns top 3 ranked snippets with line numbers from developers.gency.ai (cached 1h).

输入参数query必填

版本历史

2
  1. v0.7.0最新Oct 22, 2026
  2. v0.6.0Sep 16, 2026

评分

已满足适用检查项的 65%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Gency 集成