Skip to main content
Glama

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 configurar SEEANY_API_KEY, llama al sitio principal https://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-xxxxxxxx

No 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 smoke

Smoke 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-smoke

Conexión con Codex

codex mcp add seeany-sun-mcp -- npx --yes seeany-sun-mcp

Instalar 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@seeany

Despué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:

  1. seeany_upload_asset (si hay imagen de referencia)

  2. seeany_refine_prompt (opcional)

  3. seeany_generate_product_image

  4. seeany_wait_generation

  5. seeany_download_assets

Inspector MCP

npm run inspect

Mapeo de la API real actual

Herramienta MCP

SeeAny API

seeany_upload_asset

POST /api/upload/image

seeany_refine_prompt

POST /api/prompt-tools/ai-refine

seeany_generate_product_image

POST /api/ai/smarttask, aiTypeId=113, aiType=smartImg

seeany_get_generation / seeany_wait_generation

GET /api/developer/task/status

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-mcp

Antes de publicar, revisa el contenido del paquete:

npm run pack:check

Pruebas 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.0

release.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-oss

  • Repositorio: seeany-sun-mcp

  • Workflow: release.yml

  • Allowed action: npm publish

Available Tools

11 tools
seeany_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_accountA
Read-only

Show whether this MCP is using the local demo or the authenticated SeeAny API.

Inputs: no named parameters.

seeany_get_capabilitiesA
Read-only

List SeeAny image generation models, ratios, resolutions, and current execution mode.

Inputs: no named parameters.

seeany_get_generationA
Read-only

Get the latest status, progress, and output URLs for a SeeAny generation task.

Inputs: job_id (required).

seeany_plan_product_visualA
Read-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_generationA
Read-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_generationA
Read-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

    A3.7/5.0

    Scored across 11 tools

    Disambiguation2/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers