SeeAny Sun MCP

Dieses Verzeichnis enthält einen lokalen stdio-MCP-Server, der von MCP-Clients wie Codex, Claude Desktop, Cursor usw. aufgerufen werden kann.

Er unterstützt zwei Modi:

• demo: Kein Schlüssel erforderlich; nutzt Produktbilder aus dem Repository für eine Offline-Simulation und ruft keine kostenpflichtige API auf.

• live: Nach dem Setzen von SEEANY_API_KEY wird die Hauptseite https://api.seeany.com aufgerufen. Unterstützt werden Bild-Upload, intelligente Erstellung, Aufgaben-Polling, Download und KI-Verbesserung.

Umgebungsvariablen für die Authentifizierung

Einheitlich verwenden:

SEEANY_API_KEY=sk-sa-xxxxxxxx

Schreiben Sie den echten Schlüssel nicht in Git, Browser-Code oder Chat-Nachrichten. Kopieren Sie .env.example in Ihre lokale Umgebung und tragen Sie die Werte ein. Ohne Schlüssel wechselt der Dienst automatisch in den Demo-Modus; alternativ kann der Offline-Modus mit SEEANY_MCP_MODE=demo erzwungen werden.

Related MCP server: metalevel/snapix-mcp-server

Lokale Installation und Tests

cd mcp-server
npm install
npm run build
npm run smoke

Der Smoke-Test erzwingt den Demo-Modus und verursacht keine echten Kosten.

Falls Sie eine echte End-to-End-Abnahme durchführen möchten (diese verursacht Kosten auf dem Hauptkonto), stellen Sie sicher, dass ein neuer Schlüssel gesetzt wurde, und führen Sie dann aus:

npm run live-smoke

Codex verbinden

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

Als Codex-Plugin installieren (MCP + Skill)

Das Repository enthält außerdem ein Codex-Plugin-Manifest: Nach der Installation erhalten Sie sowohl die SeeAny-MCP-Tools als auch die Skill seeany-product-visuals für den Produktvisualisierungs-Workflow.

codex plugin marketplace add juin20260102-oss/seeany-sun-mcp --sparse .agents/plugins
codex plugin add seeany-sun-mcp@seeany

Nach der Installation starten Sie bitte eine neue Codex-Konversation; für echte Bildgenerierung muss weiterhin SEEANY_API_KEY in der lokalen Umgebung gesetzt sein. Wenn Sie nur die MCP-Tools benötigen, verwenden Sie den obigen Befehl codex mcp add.

Wenn Sie die echte API verwenden, setzen Sie SEEANY_API_KEY in derselben Umgebung, in der der MCP gestartet wird. Nach dem Verbinden empfiehlt es sich, zuerst seeany_get_capabilities aufzurufen und dann in der folgenden Reihenfolge:

1. seeany_upload_asset (wenn ein Referenzbild vorhanden ist)

2. seeany_refine_prompt (optional)

3. seeany_generate_product_image

4. seeany_wait_generation

5. seeany_download_assets

MCP Inspector

npm run inspect

Aktuelle Live-API-Zuordnung

Aufgaben verwenden standardmäßig den asynchronen Modus. Bild-/Videoaufgaben der Hauptseiten-API werden gemäß der Kontokonfiguration abgerechnet; seeany_quote_generation gibt nur einen Schätzwert zurück und zieht keine Kosten im Voraus ab.

SeeAny Skill

Das Repository enthält skills/seeany-product-visuals, um den Agenten anzuleiten, den MCP entsprechend dem vollständigen Ablauf „Referenzbild hochladen → Prompt verfeinern → Preis anfragen → generieren → abfragen → herunterladen“ aufzurufen. Das npm-Paket enthält ebenfalls dieses Skill-Verzeichnis.

npm-Paketname

Der aktuelle Paketname ist seeany-sun-mcp, geeignet für die Veröffentlichung als öffentliches Paket ohne Scope. Vor der offiziellen Veröffentlichung muss die Verfügbarkeit des Namens auf npm bestätigt werden; falls SeeAny bereits einen npm-Scope eingerichtet hat, kann auch zu @seeany/sun-mcp migriert werden.

Die einfachste Aufrufmethode nach der Veröffentlichung:

npx --yes seeany-sun-mcp

Vor der Veröffentlichung den Paketinhalt prüfen:

npm run pack:check

Automatische Tests und Veröffentlichung

GitHub Actions führt bei Push auf den main-Branch und bei Pull Requests mit Node.js 20, 22 und 24 Plugin-Validierung, MCP-Smoke-Test und npm-Paketprüfung durch.

Bei der Veröffentlichung einer neuen Version aktualisieren Sie zuerst die Versionen in package.json, package-lock.json und .codex-plugin/plugin.json synchron und erstellen dann einen Git-Tag mit derselben Version:

git tag v0.5.0
git push origin v0.5.0

release.yml überprüft, ob Tag und Paketversion übereinstimmen, und veröffentlicht anschließend über npm Trusted Publishing sowie erstellt ein GitHub Release. Vor der ersten Verwendung muss in den npm-Paketeinstellungen der GitHub-Actions-Trusted-Publisher hinzugefügt werden:

• GitHub-Benutzer: juin20260102-oss

• Repository: seeany-sun-mcp

• Workflow: release.yml

• Erlaubte Aktion: npm publish