seeany-sun-mcp
SeeAny Sun MCP
Este directorio proporciona un servidor MCP stdio local invocable por clientes MCP como Codex, Claude Desktop, Cursor, etc.
Admite dos modos:
demo: no requiere clave, utiliza las imágenes de productos del repositorio para simulación sin conexión y no llama a API de pago.live: al configurarSEEANY_API_KEY, llama al sitio principalhttps://api.seeany.com; admite subida de imágenes, creación inteligente, sondeo de tareas, descarga y refinamiento con IA.
Variable de entorno de autenticación
Se utiliza de forma unificada:
SEEANY_API_KEY=sk-sa-xxxxxxxxNo escribas la clave real en Git, en código del navegador ni en mensajes de chat. Copia .env.example a tu entorno local y complétalo. Si no hay clave, el servicio entra automáticamente en modo Demo; también puedes usar SEEANY_MCP_MODE=demo para forzar el modo sin conexión.
Related MCP server: metalevel/snapix-mcp-server
Instalación y pruebas locales
cd mcp-server
npm install
npm run build
npm run smokeSmoke test forzará el modo Demo, sin generar costes reales.
Si deseas realizar una verificación de flujo real (generará costes en la cuenta del sitio principal), asegúrate de haber configurado la nueva clave y ejecuta:
npm run live-smokeConexión con Codex
codex mcp add seeany-sun-mcp -- npx --yes seeany-sun-mcpInstalar como plugin de Codex (MCP + Skill)
El repositorio también ofrece un manifiesto de plugins de Codex: tras la instalación, obtendrás tanto las herramientas MCP de SeeAny como el Skill de flujo de trabajo de visuales de producto seeany-product-visuals.
codex plugin marketplace add juin20260102-oss/seeany-sun-mcp --sparse .agents/plugins
codex plugin add seeany-sun-mcp@seeanyDespués de la instalación, abre una nueva conversación con Codex; para generar imágenes reales, aún debes configurar SEEANY_API_KEY en el entorno local. Si solo necesitas las herramientas MCP, usa el comando codex mcp add de arriba.
Si usas la API real, configura SEEANY_API_KEY en el mismo entorno donde se inicia el MCP. Tras conectar, se recomienda llamar primero a seeany_get_capabilities y luego en el siguiente orden:
seeany_upload_asset(si hay imagen de referencia)seeany_refine_prompt(opcional)seeany_generate_product_imageseeany_wait_generationseeany_download_assets
Inspector MCP
npm run inspectMapeo de la API real actual
Herramienta MCP | SeeAny API |
|
|
|
|
|
|
|
|
Las tareas usan el modo asíncrono por defecto. Las tareas de imagen/vídeo de la API del sitio principal se facturan según la configuración de la cuenta; seeany_quote_generation solo devuelve un valor estimado y no retiene cargos por adelantado.
SeeAny Skill
El repositorio incluye skills/seeany-product-visuals, que guía al agente para llamar al MCP según el flujo completo: “subir imagen de referencia → refinar el prompt → consultar precio → generar → sondear → descargar”. El paquete npm también incluirá este directorio de Skill.
Nombre del paquete npm
El nombre actual del paquete es seeany-sun-mcp, adecuado para publicar primero un paquete público sin ámbito. Antes de la publicación oficial, debes confirmar en npm que el nombre esté disponible; si SeeAny ya ha establecido un ámbito de npm, también puedes migrar a @seeany/sun-mcp.
La forma más sencilla de invocarlo tras la publicación:
npx --yes seeany-sun-mcpAntes de publicar, revisa el contenido del paquete:
npm run pack:checkPruebas automáticas y publicación
GitHub Actions ejecutará la validación de plugins, MCP Smoke Test y la comprobación del empaquetado npm con Node.js 20, 22 y 24 en los Push y Pull Requests de la rama main.
Al publicar una nueva versión, actualiza primero de forma sincronizada las versiones de package.json, package-lock.json y .codex-plugin/plugin.json, y luego crea una Git Tag con la misma versión:
git tag v0.5.0
git push origin v0.5.0release.yml verificará que la Tag coincida con la versión del paquete, y luego publicará mediante npm Trusted Publishing y creará una GitHub Release. Antes del primer uso, debes añadir GitHub Actions Trusted Publisher en la configuración del paquete npm:
Usuario de GitHub:
juin20260102-ossRepositorio:
seeany-sun-mcpWorkflow:
release.ymlAllowed action:
npm publish
Available Tools
11 toolsseeany_create_product_visualA
Execute a previously quoted product-visual plan, wait for its stored job, and download outputs. In live mode confirm_cost must be true. Reusing a plan_id resumes its recorded job instead of submitting another one.
Inputs: plan_id (required), confirm_cost (required), output_dir, timeout_seconds.
seeany_download_assetsA
Download completed SeeAny output images into a local directory and return their file paths.
Inputs: job_id (required), output_dir (required).
seeany_generate_product_imageB
Create an asynchronous SeeAny product-image task, then use seeany_wait_generation to receive results.
Inputs: prompt (required), count, model, use_case, +3 more.
seeany_get_accountARead-only
Show whether this MCP is using the local demo or the authenticated SeeAny API.
Inputs: no named parameters.
seeany_get_capabilitiesARead-only
List SeeAny image generation models, ratios, resolutions, and current execution mode.
Inputs: no named parameters.
seeany_get_generationARead-only
Get the latest status, progress, and output URLs for a SeeAny generation task.
Inputs: job_id (required).
seeany_plan_product_visualARead-only
Plan a complete product-visual job and estimate its cost without creating a paid generation task. Returns a plan_id for explicit execution.
Inputs: request (required), count, model, use_case, +4 more.
seeany_quote_generationARead-only
Estimate generation cost before creating a task. This is an estimate and does not reserve credits.
Inputs: count (required), model (required), use_case (required), resolution.
seeany_refine_promptB
Use SeeAny AI prompt refinement to turn a rough product-image request into a production-ready prompt.
Inputs: prompt (required), action, extra_context, reference_asset_ids.
seeany_upload_assetA
Upload a local product image to SeeAny and return an asset id and URL for later generation.
Inputs: file_path (required).
seeany_wait_generationARead-only
Poll a SeeAny generation task until it reaches a terminal state or the timeout expires.
Inputs: job_id (required), timeout_seconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Several tools overlap: seeany_plan_product_visual and seeany_quote_generation both estimate costs, while seeany_create_product_visual and seeany_generate_product_image both create generation jobs and handle waiting/downloading. The separate 'visual' and 'image' workflows are not clearly distinguished by descriptions, so an agent could easily pick the wrong one.
All tools share the seeany_ prefix and follow a consistent verb_noun snake_case pattern (get_account, upload_asset, generate_product_image, wait_generation). There are no mixed conventions or unpredictable names.
At 11 tools, the server is within a reasonable scope for an image-generation API client. It could be trimmed by consolidating overlapping quote/plan and create/generate tools, but the count is not excessive.
The core lifecycle is covered: asset upload, prompt refinement, cost estimation, job creation, status polling, waiting, and downloading outputs. Missing cancellation or asset listing are minor gaps, not dead ends.
Maintenance
Related MCP Connectors
MCP server for ByteDance Seedream AI image generation
MCP server for Wan AI video generation
MCP server for Qwen Image 3 AI image generation
MCP server for Product Management
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for multi-provider AI image generation (AWS Bedrock, OpenAI, Google Gemini) enabling image generation, transformation, and editing through a unified interface.41MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for image optimization, conversion, AI generation, and gallery management via SnapiX API.4 npmMIT
- FlicenseAqualityBmaintenanceMCP server for the company image2 text-to-image API, enabling AI tools to generate images directly from text prompts.2-
- AlicenseAqualityCmaintenanceMCP server for OfflineCreator Studio that enables image and video generation, including model listing, credit management, generation tasks, and output downloads.9120 npmMIT