SeeAny Sun MCP

このディレクトリは、Codex、Claude Desktop、Cursor などの MCP クライアントから呼び出せるローカル stdio MCP サーバーを提供します。

次の 2 つのモードをサポートしています：

• demo：キーは不要で、リポジトリ内の商品画像を使用してオフラインでシミュレーションします。有料 API は呼び出しません。

• live：SEEANY_API_KEY を設定すると、メインサイト https://api.seeany.com を呼び出します。画像アップロード、スマート生成、タスクポーリング、ダウンロード、AI リライトをサポートします。

認証環境変数

共通で使用します：

SEEANY_API_KEY=sk-sa-xxxxxxxx

実際の Key を Git、ブラウザコード、チャットメッセージに書き込まないでください。.env.example をローカル環境にコピーしてから記入してください。Key がない場合、サービスは自動的に Demo モードになります。SEEANY_MCP_MODE=demo でオフラインモードを強制することもできます。

Related MCP server: metalevel/snapix-mcp-server

ローカルインストールとテスト

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

Smoke test は Demo モードを強制するため、実際の費用は発生しません。

実際の一連の流れでの検収を 1 回実行する場合（メインサイトのアカウント費用が発生します）は、新しい Key が設定されていることを確認してから次を実行してください：

npm run live-smoke

Codex への接続

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

Codex プラグインとしてインストール（MCP + Skill）

リポジトリには Codex プラグインのマニフェストも用意されています。インストールすると、SeeAny MCP ツールと seeany-product-visuals 商品ビジュアルワークフロー Skill の両方を同時に利用できます。

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

インストール後は、新しい Codex セッションを開いてください。実際に画像を生成する場合も、ローカル環境で SEEANY_API_KEY を設定する必要があります。MCP ツールのみが必要な場合は、上記の codex mcp add を使用してください。

実際の API を使用する場合は、MCP を起動するのと同じ環境で SEEANY_API_KEY を設定してください。接続後は、まず seeany_get_capabilities を呼び出し、その後以下の順序で呼び出すことをお勧めします：

1. seeany_upload_asset（参考画像がある場合）

2. seeany_refine_prompt（オプション）

3. seeany_generate_product_image

4. seeany_wait_generation

5. seeany_download_assets

MCP Inspector

npm run inspect

現在の実 API マッピング

タスクはデフォルトで非同期モードになります。メインサイト API の画像/動画タスクはアカウント設定に応じて課金されます。seeany_quote_generation は見積もり値のみを返し、費用を事前に差し引きません。

SeeAny Skill

リポジトリ内には skills/seeany-product-visuals が含まれており、「参考画像のアップロード → プロンプトのリライト → 見積もり → 生成 → ポーリング → ダウンロード」という完全なフローで MCP を呼び出すよう Agent をガイドします。npm パッケージにもこの Skill ディレクトリが含まれます。

npm パッケージ名

現在のパッケージ名は seeany-sun-mcp で、まず公開のスコープなしパッケージとして公開するのに適しています。正式公開前に npm で名前が利用可能かどうかを確認する必要があります。SeeAny が npm スコープを確立している場合は、@seeany/sun-mcp に移行することもできます。

公開後の最も簡単な呼び出し方法：

npx --yes seeany-sun-mcp

公開前にパッケージの内容を確認：

npm run pack:check

自動テストと公開

GitHub Actions は、main ブランチへの Push と Pull Request の際に、Node.js 20、22、24 を使用してプラグイン検証、MCP Smoke Test、npm パッケージのチェックを実行します。

新バージョンを公開するときは、まず package.json、package-lock.json、.codex-plugin/plugin.json のバージョンを同期して更新し、同じバージョンの Git Tag を作成します：

git tag v0.5.0
git push origin v0.5.0

release.yml は Tag とパッケージバージョンが一致することを検証し、npm Trusted Publishing を介して公開して GitHub Release を作成します。初回使用前に、npm パッケージの設定に GitHub Actions Trusted Publisher を追加する必要があります：

• GitHub ユーザー：juin20260102-oss

• リポジトリ：seeany-sun-mcp

• Workflow：release.yml

• Allowed action：npm publish