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

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