@yoonion/mimi-seed-mcp 0.3.22 → 0.3.23

package/dist/index.js

@@ -11,6 +11,7 @@ import { registerAiTools } from './registers/ai.js';
 import { registerBigqueryTools } from './registers/bigquery.js';
 import { registerAuthTools } from './registers/auth.js';
 import { registerCiTools } from './registers/ci.js';
+import { registerInstagramTools } from './registers/instagram.js';
 import { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 const server = new McpServer({
@@ -27,6 +28,7 @@ registerAiTools(server);
 registerBigqueryTools(server);
 registerAuthTools(server);
 registerCiTools(server);
+registerInstagramTools(server);
 registerPrompts(server);
 registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.

package/dist/instagram/api.d.ts

@@ -0,0 +1,17 @@
+import type { InstagramConfig } from './config.js';
+export interface InstagramAccount {
+    id: string;
+    username: string;
+    name?: string;
+    profile_picture_url?: string;
+    account_type?: string;
+    followers_count?: number;
+    media_count?: number;
+}
+export declare function getAccount(cfg: InstagramConfig): Promise<InstagramAccount>;
+export interface PublishResult {
+    id: string;
+    permalink?: string;
+}
+export declare function postImage(cfg: InstagramConfig, imageUrl: string, caption: string): Promise<PublishResult>;
+export declare function postCarousel(cfg: InstagramConfig, imageUrls: string[], caption: string): Promise<PublishResult>;

package/dist/instagram/api.js

@@ -0,0 +1,81 @@
+const BASE = 'https://graph.facebook.com/v21.0';
+async function igFetch(endpoint, params, method = 'GET') {
+    const url = new URL(`${BASE}${endpoint}`);
+    let body;
+    if (method === 'GET') {
+        Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    }
+    else {
+        body = new URLSearchParams(params).toString();
+    }
+    const res = await fetch(url.toString(), {
+        method,
+        body,
+        headers: method === 'POST' ? { 'Content-Type': 'application/x-www-form-urlencoded' } : undefined,
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        let msg = text;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed.error) {
+                msg = `${parsed.error.message} (code ${parsed.error.code}${parsed.error.error_subcode ? `/${parsed.error.error_subcode}` : ''})`;
+            }
+        }
+        catch { /* fall through with raw text */ }
+        throw new Error(`Instagram API ${res.status}: ${msg}`);
+    }
+    return JSON.parse(text);
+}
+export async function getAccount(cfg) {
+    return igFetch(`/${cfg.userId}`, {
+        fields: 'id,username,name,profile_picture_url,account_type,followers_count,media_count',
+        access_token: cfg.accessToken,
+    });
+}
+async function fetchPermalink(cfg, mediaId) {
+    try {
+        const meta = await igFetch(`/${mediaId}`, {
+            fields: 'permalink',
+            access_token: cfg.accessToken,
+        });
+        return meta.permalink;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function postImage(cfg, imageUrl, caption) {
+    // Step 1: image container 생성
+    const container = await igFetch(`/${cfg.userId}/media`, { image_url: imageUrl, caption, access_token: cfg.accessToken }, 'POST');
+    // Step 2: publish
+    const published = await igFetch(`/${cfg.userId}/media_publish`, { creation_id: container.id, access_token: cfg.accessToken }, 'POST');
+    return {
+        id: published.id,
+        permalink: await fetchPermalink(cfg, published.id),
+    };
+}
+export async function postCarousel(cfg, imageUrls, caption) {
+    if (imageUrls.length < 2 || imageUrls.length > 10) {
+        throw new Error(`캐러셀은 2~10장의 이미지가 필요합니다 (받은 수: ${imageUrls.length}).`);
+    }
+    // Step 1: 각 이미지를 children container로 생성 (sequential — 일부 실패 시 부분 결과 명확)
+    const childIds = [];
+    for (const url of imageUrls) {
+        const child = await igFetch(`/${cfg.userId}/media`, { image_url: url, is_carousel_item: 'true', access_token: cfg.accessToken }, 'POST');
+        childIds.push(child.id);
+    }
+    // Step 2: carousel container 생성
+    const carousel = await igFetch(`/${cfg.userId}/media`, {
+        media_type: 'CAROUSEL',
+        children: childIds.join(','),
+        caption,
+        access_token: cfg.accessToken,
+    }, 'POST');
+    // Step 3: publish
+    const published = await igFetch(`/${cfg.userId}/media_publish`, { creation_id: carousel.id, access_token: cfg.accessToken }, 'POST');
+    return {
+        id: published.id,
+        permalink: await fetchPermalink(cfg, published.id),
+    };
+}

package/dist/instagram/config.d.ts

@@ -0,0 +1,9 @@
+export interface InstagramConfig {
+    accessToken: string;
+    userId: string;
+    expiresAt?: string;
+    username?: string;
+}
+export declare function loadInstagramConfig(): InstagramConfig | null;
+export declare function saveInstagramConfig(cfg: InstagramConfig): void;
+export declare function requireInstagramConfig(): InstagramConfig;

package/dist/instagram/config.js

@@ -0,0 +1,31 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'instagram.json');
+export function loadInstagramConfig() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveInstagramConfig(cfg) {
+    const dir = path.dirname(CONFIG_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+    if (process.platform !== 'win32') {
+        fs.chmodSync(CONFIG_PATH, 0o600);
+    }
+}
+export function requireInstagramConfig() {
+    const cfg = loadInstagramConfig();
+    if (!cfg) {
+        throw new Error('Instagram 설정이 없습니다.\n' +
+            'instagram_save_config 도구로 먼저 설정해주세요.\n' +
+            '예: instagram_save_config(accessToken="...", userId="...")');
+    }
+    return cfg;
+}

package/dist/registers/instagram.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInstagramTools(server: McpServer): void;

package/dist/registers/instagram.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { requireInstagramConfig, saveInstagramConfig } from '../instagram/config.js';
+import * as api from '../instagram/api.js';
+export function registerInstagramTools(server) {
+    server.tool('instagram_save_config', [
+        'Instagram Graph API 토큰을 ~/.mimi-seed/instagram.json (mode 0600)에 저장합니다.',
+        'accessToken: long-lived (60일) — developers.facebook.com → Graph API Explorer에서 발급.',
+        'userId: Instagram Business Account ID — GET /me/accounts → instagram_business_account.id 로 조회.',
+        '권한: instagram_basic + instagram_content_publish 필수.',
+        '저장 후 instagram_get_account 로 토큰 검증 권장.',
+    ].join(' '), {
+        accessToken: z.string().describe('Long-lived access token (60일 유효)'),
+        userId: z.string().describe('Instagram Business Account ID'),
+        assumeIssuedNow: z.boolean().default(true).describe('issuedAt을 지금으로 가정하고 expiresAt = +60일 자동 계산'),
+    }, async ({ accessToken, userId, assumeIssuedNow }) => {
+        const expiresAt = assumeIssuedNow
+            ? new Date(Date.now() + 60 * 24 * 60 * 60 * 1000).toISOString()
+            : undefined;
+        saveInstagramConfig({ accessToken, userId, expiresAt });
+        // 검증 — 잘못된 토큰이면 즉시 알림
+        try {
+            const account = await api.getAccount({ accessToken, userId });
+            // 검증 성공 시 username 추가 저장
+            saveInstagramConfig({ accessToken, userId, expiresAt, username: account.username });
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `✅ Instagram 연결 확인 완료`,
+                            `   계정: @${account.username}${account.name ? ` (${account.name})` : ''}`,
+                            `   ID: ${account.id}`,
+                            account.account_type ? `   타입: ${account.account_type}` : '',
+                            account.followers_count !== undefined ? `   팔로워: ${account.followers_count.toLocaleString()}` : '',
+                            expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
+                        ].filter(Boolean).join('\n'),
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `⚠️ 설정은 저장됐지만 토큰 검증 실패`,
+                            `   ${err.message}`,
+                            ``,
+                            `토큰/userId를 다시 확인하세요.`,
+                            `instagram_save_config 로 재저장 가능.`,
+                        ].join('\n'),
+                    }],
+            };
+        }
+    });
+    server.tool('instagram_get_account', 'Instagram 계정 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
+        const cfg = requireInstagramConfig();
+        const account = await api.getAccount(cfg);
+        const remainingDays = cfg.expiresAt
+            ? Math.round((new Date(cfg.expiresAt).getTime() - Date.now()) / (24 * 60 * 60 * 1000))
+            : null;
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `@${account.username}${account.name ? ` (${account.name})` : ''}`,
+                        `   ID: ${account.id}`,
+                        account.account_type ? `   타입: ${account.account_type}` : '',
+                        account.followers_count !== undefined ? `   팔로워: ${account.followers_count.toLocaleString()}` : '',
+                        account.media_count !== undefined ? `   게시물: ${account.media_count}` : '',
+                        remainingDays !== null
+                            ? remainingDays > 7
+                                ? `   토큰: ${remainingDays}일 남음`
+                                : remainingDays > 0
+                                    ? `   ⚠️ 토큰 ${remainingDays}일 남음 — 곧 갱신 필요`
+                                    : `   ❌ 토큰 만료됨 — instagram_save_config로 재저장`
+                            : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('instagram_post_image', [
+        '단일 이미지를 Instagram에 게시합니다.',
+        'imageUrl은 public URL이어야 합니다 (Graph API 제약). 로컬 파일은 미리 S3/R2/Cloudinary 등에 업로드 필요.',
+        '캡션에는 해시태그(#)와 멘션(@) 포함 가능. 줄바꿈 \\n 사용.',
+        '2-step API: container 생성 → media_publish.',
+    ].join(' '), {
+        imageUrl: z.string().url().describe('이미지의 public URL (HTTPS 권장)'),
+        caption: z.string().describe('캡션 — 해시태그/멘션/줄바꿈 포함 가능'),
+    }, async ({ imageUrl, caption }) => {
+        const cfg = requireInstagramConfig();
+        const result = await api.postImage(cfg, imageUrl, caption);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ 게시 완료`,
+                        `   media_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('instagram_post_carousel', [
+        '여러 이미지를 캐러셀(swipe)로 게시합니다. 2~10장.',
+        '모든 이미지는 public URL이어야 함.',
+        '3-step API: 각 이미지 children container → carousel container → publish.',
+        '일부 이미지에서 실패하면 전체 실패 (이미 만든 children container는 자동 삭제 안 됨 — Instagram이 알아서 처리).',
+    ].join(' '), {
+        imageUrls: z.array(z.string().url()).min(2).max(10).describe('이미지 URL 배열 (2~10장)'),
+        caption: z.string().describe('캡션'),
+    }, async ({ imageUrls, caption }) => {
+        const cfg = requireInstagramConfig();
+        const result = await api.postCarousel(cfg, imageUrls, caption);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ 캐러셀 ${imageUrls.length}장 게시 완료`,
+                        `   media_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Cursor / any MCP client.",
   "type": "module",
   "bin": {