@yoonion/mimi-seed-mcp 0.3.24 → 0.3.25

package/dist/facebook/api.d.ts

@@ -0,0 +1,16 @@
+import type { FacebookConfig } from './config.js';
+export interface FacebookPage {
+    id: string;
+    name: string;
+    category?: string;
+    followers_count?: number;
+    fan_count?: number;
+}
+export interface PostResult {
+    id: string;
+    permalink?: string;
+}
+export declare function getPage(cfg: FacebookConfig): Promise<FacebookPage>;
+export declare function postPhoto(cfg: FacebookConfig, imageUrl: string, caption: string): Promise<PostResult>;
+export declare function postMultiPhoto(cfg: FacebookConfig, imageUrls: string[], caption: string): Promise<PostResult>;
+export declare function listAccessiblePages(userAccessToken: string): Promise<FacebookPage[]>;

package/dist/facebook/api.js

@@ -0,0 +1,98 @@
+const BASE = 'https://graph.facebook.com/v21.0';
+async function fbPost(pageAccessToken, endpoint, params) {
+    const body = new URLSearchParams({ ...params, access_token: pageAccessToken });
+    const res = await fetch(`${BASE}${endpoint}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: body.toString(),
+    });
+    const text = await res.text();
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    if (json.error) {
+        const err = json.error;
+        throw new Error(`${err.message} (code ${err.code})`);
+    }
+    return json;
+}
+async function fbGet(pageAccessToken, endpoint, params = {}) {
+    const qs = new URLSearchParams({ ...params, access_token: pageAccessToken });
+    const res = await fetch(`${BASE}${endpoint}?${qs}`);
+    const json = await res.json();
+    if (json.error) {
+        const err = json.error;
+        throw new Error(`${err.message} (code ${err.code})`);
+    }
+    return json;
+}
+export async function getPage(cfg) {
+    const data = await fbGet(cfg.pageAccessToken, `/${cfg.pageId}`, {
+        fields: 'id,name,category,followers_count,fan_count',
+    });
+    return data;
+}
+// Step 1: upload photo as unpublished, returns photo ID
+async function uploadUnpublishedPhoto(cfg, imageUrl) {
+    const result = await fbPost(cfg.pageAccessToken, `/${cfg.pageId}/photos`, {
+        url: imageUrl,
+        published: 'false',
+    });
+    return result.id;
+}
+export async function postPhoto(cfg, imageUrl, caption) {
+    const result = await fbPost(cfg.pageAccessToken, `/${cfg.pageId}/photos`, {
+        url: imageUrl,
+        message: caption,
+        published: 'true',
+    });
+    const postId = result.post_id ?? result.id;
+    let permalink;
+    try {
+        const info = await fbGet(cfg.pageAccessToken, `/${postId}`, { fields: 'permalink_url' });
+        permalink = info.permalink_url;
+    }
+    catch { /* best-effort */ }
+    return { id: postId, permalink };
+}
+export async function postMultiPhoto(cfg, imageUrls, caption) {
+    if (imageUrls.length < 2 || imageUrls.length > 10) {
+        throw new Error('이미지는 2~10장이어야 합니다.');
+    }
+    // Step 1: upload each as unpublished photo
+    const photoIds = [];
+    for (const url of imageUrls) {
+        const id = await uploadUnpublishedPhoto(cfg, url);
+        photoIds.push(id);
+    }
+    // Step 2: create feed post with all photos attached
+    const attachedMedia = photoIds.map(id => JSON.stringify({ media_fbid: id }));
+    const result = await fbPost(cfg.pageAccessToken, `/${cfg.pageId}/feed`, {
+        message: caption,
+        attached_media: `[${attachedMedia.join(',')}]`,
+    });
+    const postId = result.id;
+    let permalink;
+    try {
+        const info = await fbGet(cfg.pageAccessToken, `/${postId}`, { fields: 'permalink_url' });
+        permalink = info.permalink_url;
+    }
+    catch { /* best-effort */ }
+    return { id: postId, permalink };
+}
+// Fetch all pages accessible with a User Access Token
+export async function listAccessiblePages(userAccessToken) {
+    const qs = new URLSearchParams({
+        fields: 'id,name,category',
+        access_token: userAccessToken,
+    });
+    const res = await fetch(`${BASE}/me/accounts?${qs}`);
+    const json = await res.json();
+    if (json.error)
+        throw new Error(`${json.error.message} (code ${json.error.code})`);
+    return json.data ?? [];
+}

package/dist/facebook/config.d.ts

@@ -0,0 +1,9 @@
+export interface FacebookConfig {
+    pageAccessToken: string;
+    pageId: string;
+    pageName?: string;
+    expiresAt?: string;
+}
+export declare function loadFacebookConfig(): FacebookConfig | null;
+export declare function saveFacebookConfig(cfg: FacebookConfig): void;
+export declare function requireFacebookConfig(): FacebookConfig;

package/dist/facebook/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', 'facebook.json');
+export function loadFacebookConfig() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveFacebookConfig(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 requireFacebookConfig() {
+    const cfg = loadFacebookConfig();
+    if (!cfg) {
+        throw new Error('Facebook 설정이 없습니다.\n' +
+            'facebook_save_config 도구로 먼저 설정해주세요.\n' +
+            '예: facebook_save_config(pageAccessToken="EAA...", pageId="...")');
+    }
+    return cfg;
+}

package/dist/index.js

@@ -12,6 +12,7 @@ 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 { registerFacebookTools } from './registers/facebook.js';
 import { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 const server = new McpServer({
@@ -29,6 +30,7 @@ registerBigqueryTools(server);
 registerAuthTools(server);
 registerCiTools(server);
 registerInstagramTools(server);
+registerFacebookTools(server);
 registerPrompts(server);
 registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.

package/dist/registers/facebook.d.ts

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

package/dist/registers/facebook.js

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+import { loadFacebookConfig, requireFacebookConfig, saveFacebookConfig } from '../facebook/config.js';
+import * as api from '../facebook/api.js';
+export function registerFacebookTools(server) {
+    server.tool('facebook_save_config', [
+        'Facebook 페이지 액세스 토큰을 ~/.mimi-seed/facebook.json (mode 0600)에 저장합니다.',
+        'pageAccessToken: Graph API Explorer 또는 /me/accounts로 발급한 Page Access Token (EAA...).',
+        'pageId 미입력 시 토큰으로 자동 조회 (/me → id 필드).',
+        '저장 직후 페이지 정보를 조회해 토큰 유효성도 자동 검증.',
+    ].join(' '), {
+        pageAccessToken: z.string().describe('Facebook Page Access Token (EAA..., long-lived 권장)'),
+        pageId: z.string().optional().describe('Facebook Page ID (생략 시 토큰에서 자동 조회)'),
+    }, async ({ pageAccessToken, pageId }) => {
+        // Resolve pageId
+        let resolvedPageId = pageId;
+        if (!resolvedPageId) {
+            try {
+                const me = await api.listAccessiblePages(pageAccessToken);
+                if (me.length === 0) {
+                    // Try /me directly (already a Page Access Token)
+                    const res = await fetch(`https://graph.facebook.com/v21.0/me?fields=id,name&access_token=${pageAccessToken}`);
+                    const data = await res.json();
+                    if (data.error)
+                        throw new Error(`${data.error.message} (code ${data.error.code})`);
+                    resolvedPageId = data.id;
+                }
+                else if (me.length === 1) {
+                    resolvedPageId = me[0].id;
+                }
+                else {
+                    const list = me.map(p => `  • ${p.name} (${p.id})`).join('\n');
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: [
+                                    '여러 페이지에 접근 가능합니다. pageId를 명시해주세요:',
+                                    list,
+                                ].join('\n'),
+                            }],
+                    };
+                }
+            }
+            catch (err) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ pageId 자동 조회 실패: ${err.message}`,
+                        }],
+                };
+            }
+        }
+        try {
+            const cfg = { pageAccessToken, pageId: resolvedPageId };
+            const page = await api.getPage(cfg);
+            saveFacebookConfig({
+                pageAccessToken,
+                pageId: resolvedPageId,
+                pageName: page.name,
+                expiresAt: new Date(Date.now() + 60 * 24 * 60 * 60 * 1000).toISOString(),
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `✅ Facebook 페이지 연결 완료`,
+                            `   페이지: ${page.name}`,
+                            `   ID: ${page.id}`,
+                            page.category ? `   카테고리: ${page.category}` : '',
+                            page.followers_count !== undefined ? `   팔로워: ${page.followers_count.toLocaleString()}` : '',
+                            page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
+                        ].filter(Boolean).join('\n'),
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `❌ 토큰 검증 실패`,
+                            `   ${err.message}`,
+                            ``,
+                            `Page Access Token을 다시 확인하거나 facebook_list_pages로 페이지 목록을 조회하세요.`,
+                        ].join('\n'),
+                    }],
+            };
+        }
+    });
+    server.tool('facebook_list_pages', 'User Access Token으로 접근 가능한 Facebook 페이지 목록을 조회합니다. 페이지별 Page Access Token도 함께 반환.', {
+        userAccessToken: z.string().describe('Facebook User Access Token (EAA...)'),
+    }, async ({ userAccessToken }) => {
+        const pages = await api.listAccessiblePages(userAccessToken);
+        if (pages.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '접근 가능한 페이지가 없습니다. pages_show_list 권한이 있는 토큰인지 확인하세요.',
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `접근 가능한 페이지 ${pages.length}개:`,
+                        ...pages.map(p => `  • ${p.name} (ID: ${p.id})${p.category ? ` — ${p.category}` : ''}`),
+                    ].join('\n'),
+                }],
+        };
+    });
+    server.tool('facebook_get_page', 'Facebook 페이지 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
+        const cfg = requireFacebookConfig();
+        const page = await api.getPage(cfg);
+        const remainingDays = cfg.expiresAt
+            ? Math.round((new Date(cfg.expiresAt).getTime() - Date.now()) / (24 * 60 * 60 * 1000))
+            : null;
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `${page.name} (ID: ${page.id})`,
+                        page.category ? `   카테고리: ${page.category}` : '',
+                        page.followers_count !== undefined ? `   팔로워: ${page.followers_count.toLocaleString()}` : '',
+                        page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
+                        remainingDays !== null
+                            ? remainingDays > 7
+                                ? `   토큰: ${remainingDays}일 남음`
+                                : remainingDays > 0
+                                    ? `   ⚠️ 토큰 ${remainingDays}일 남음 — 갱신 필요`
+                                    : `   ❌ 토큰 만료 — facebook_save_config로 재저장`
+                            : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('facebook_post_photo', [
+        '단일 이미지를 Facebook 페이지에 게시합니다.',
+        'imageUrl은 public URL이어야 합니다.',
+    ].join(' '), {
+        imageUrl: z.string().url().describe('이미지의 public URL (HTTPS 권장)'),
+        caption: z.string().describe('게시글 본문'),
+    }, async ({ imageUrl, caption }) => {
+        const cfg = requireFacebookConfig();
+        const result = await api.postPhoto(cfg, imageUrl, caption);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ 게시 완료`,
+                        `   post_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('facebook_post_multi_photo', [
+        '여러 이미지를 하나의 게시물로 Facebook 페이지에 게시합니다. 2~10장.',
+        '모든 이미지는 public URL이어야 합니다.',
+        '각 이미지를 unpublished photo로 업로드한 뒤 하나의 feed 게시물로 묶습니다.',
+    ].join(' '), {
+        imageUrls: z.array(z.string().url()).min(2).max(10).describe('이미지 URL 배열 (2~10장)'),
+        caption: z.string().describe('게시글 본문'),
+    }, async ({ imageUrls, caption }) => {
+        const cfg = requireFacebookConfig();
+        const result = await api.postMultiPhoto(cfg, imageUrls, caption);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ ${imageUrls.length}장 게시 완료`,
+                        `   post_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    // Config load helper
+    server.tool('facebook_current_config', '현재 저장된 Facebook 페이지 설정을 확인합니다.', {}, async () => {
+        const cfg = loadFacebookConfig();
+        if (!cfg) {
+            return {
+                content: [{ type: 'text', text: '저장된 Facebook 설정 없음. facebook_save_config로 등록하세요.' }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `페이지: ${cfg.pageName ?? '(미확인)'} (${cfg.pageId})`,
+                        cfg.expiresAt ? `토큰 만료(추정): ${cfg.expiresAt.slice(0, 10)}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+}

package/package.json

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