@yoonion/mimi-seed-mcp 0.3.22 → 0.3.24

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,19 @@
+import type { InstagramConfig } from './config.js';
+export declare function apiBaseFor(token: string): string;
+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 declare function fetchUserId(accessToken: string): Promise<string>;
+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,108 @@
+// 두 가지 Meta API:
+//   IGAA... = Instagram API with Instagram Login (2024 신규) — graph.instagram.com
+//   EAA...  = Instagram Graph API via Facebook Login                — graph.facebook.com
+// 토큰 prefix로 자동 분기. 엔드포인트 path는 둘 다 동일.
+export function apiBaseFor(token) {
+    if (token.startsWith('IGAA'))
+        return 'https://graph.instagram.com/v21.0';
+    return 'https://graph.facebook.com/v21.0';
+}
+async function igFetch(token, endpoint, params, method = 'GET') {
+    const url = new URL(`${apiBaseFor(token)}${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) {
+    // graph.instagram.com 은 name/profile_picture_url 필드를 받지 않을 수 있어
+    // 두 API 공통으로 안전한 필드만 요청
+    const fields = cfg.accessToken.startsWith('IGAA')
+        ? 'id,username,account_type,followers_count,media_count'
+        : 'id,username,name,profile_picture_url,account_type,followers_count,media_count';
+    return igFetch(cfg.accessToken, `/${cfg.userId}`, {
+        fields,
+        access_token: cfg.accessToken,
+    });
+}
+// 토큰만으로 user ID 자동 조회 (양쪽 API 지원)
+export async function fetchUserId(accessToken) {
+    if (accessToken.startsWith('IGAA')) {
+        // Instagram Login: GET /me?fields=user_id,username
+        const res = await igFetch(accessToken, '/me', { fields: 'user_id,username', access_token: accessToken });
+        // graph.instagram.com 은 v21.0에서 user_id 또는 id 둘 중 하나 반환
+        return res.user_id ?? res.id;
+    }
+    // Facebook Login: GET /me/accounts → instagram_business_account.id
+    const res = await igFetch(accessToken, '/me/accounts', { fields: 'instagram_business_account', access_token: accessToken });
+    const id = res.data?.[0]?.instagram_business_account?.id;
+    if (!id) {
+        throw new Error('Facebook Page에 연결된 Instagram Business Account를 찾지 못했습니다.\n' +
+            'Facebook Page → Settings → Linked Accounts에서 IG 계정을 연결하세요.');
+    }
+    return id;
+}
+async function fetchPermalink(cfg, mediaId) {
+    try {
+        const meta = await igFetch(cfg.accessToken, `/${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.accessToken, `/${cfg.userId}/media`, { image_url: imageUrl, caption, access_token: cfg.accessToken }, 'POST');
+    // Step 2: publish
+    const published = await igFetch(cfg.accessToken, `/${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.accessToken, `/${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.accessToken, `/${cfg.userId}/media`, {
+        media_type: 'CAROUSEL',
+        children: childIds.join(','),
+        caption,
+        access_token: cfg.accessToken,
+    }, 'POST');
+    // Step 3: publish
+    const published = await igFetch(cfg.accessToken, `/${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,152 @@
+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 토큰을 ~/.mimi-seed/instagram.json (mode 0600)에 저장합니다.',
+        'accessToken은 두 형식 모두 자동 감지:',
+        '  IGAA... = Instagram API with Instagram Login (Meta 신규, FB Page 불필요)',
+        '  EAA...  = Instagram Graph API via Facebook Login (FB Page+IG Business 연결 필요)',
+        'userId 미입력 시 토큰으로 자동 조회 (/me 또는 /me/accounts).',
+        '저장 직후 토큰 유효성도 자동 검증.',
+    ].join(' '), {
+        accessToken: z.string().describe('Long-lived access token (60일)'),
+        userId: z.string().optional().describe('Instagram Business Account ID (생략 시 자동 조회)'),
+        assumeIssuedNow: z.boolean().default(true).describe('expiresAt = 지금 + 60일 자동 계산'),
+    }, async ({ accessToken, userId, assumeIssuedNow }) => {
+        const apiType = accessToken.startsWith('IGAA') ? 'Instagram Login' : 'Facebook Login';
+        // userId 자동 조회
+        let resolvedUserId = userId;
+        if (!resolvedUserId) {
+            try {
+                resolvedUserId = await api.fetchUserId(accessToken);
+            }
+            catch (err) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: [
+                                `❌ userId 자동 조회 실패 (${apiType})`,
+                                `   ${err.message}`,
+                                ``,
+                                `userId를 명시적으로 전달하거나 토큰을 다시 확인하세요.`,
+                            ].join('\n'),
+                        }],
+                };
+            }
+        }
+        const expiresAt = assumeIssuedNow
+            ? new Date(Date.now() + 60 * 24 * 60 * 60 * 1000).toISOString()
+            : undefined;
+        // 검증 — 잘못된 토큰이면 즉시 알림
+        try {
+            const account = await api.getAccount({ accessToken, userId: resolvedUserId });
+            // 검증 성공 → 최종 저장
+            saveInstagramConfig({
+                accessToken,
+                userId: resolvedUserId,
+                expiresAt,
+                username: account.username,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `✅ Instagram 연결 확인 완료 (${apiType})`,
+                            `   계정: @${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}` : '',
+                            expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
+                        ].filter(Boolean).join('\n'),
+                    }],
+            };
+        }
+        catch (err) {
+            // 검증 실패 — 저장은 하지 않고 사용자에게 알림
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `❌ 토큰 검증 실패 (${apiType})`,
+                            `   userId: ${resolvedUserId}`,
+                            `   ${err.message}`,
+                            ``,
+                            `토큰을 다시 발급받거나 userId를 직접 지정해보세요.`,
+                        ].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.24",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Cursor / any MCP client.",
   "type": "module",
   "bin": {