@atikk-co-jp/notion-mcp-server 0.1.0 → 0.2.0

package/dist/src/converters/block-to-markdown.js

@@ -0,0 +1,484 @@
+/**
+ * Notionブロックをマークダウン文字列に変換するモジュール
+ */
+import { richTextToMarkdown } from './rich-text-to-markdown.js';
+/**
+ * ファイルオブジェクトからURLを抽出
+ */
+function extractFileUrl(fileObj) {
+    if (!fileObj)
+        return '';
+    if (fileObj.type === 'external' && fileObj.external?.url) {
+        return fileObj.external.url;
+    }
+    if (fileObj.type === 'file' && fileObj.file?.url) {
+        return fileObj.file.url;
+    }
+    // type が指定されていない場合のフォールバック
+    if (fileObj.external?.url)
+        return fileObj.external.url;
+    if (fileObj.file?.url)
+        return fileObj.file.url;
+    return '';
+}
+/**
+ * アイコンからテキストを抽出
+ */
+function extractIconText(icon) {
+    if (!icon)
+        return '';
+    if (icon.type === 'emoji' && icon.emoji) {
+        return icon.emoji;
+    }
+    return '';
+}
+/**
+ * 単一のブロックをマークダウンに変換
+ */
+async function convertBlock(block, options = {}) {
+    const indent = '  '.repeat(options.indentLevel ?? 0);
+    const blockData = block[block.type];
+    if (!blockData && block.type !== 'divider') {
+        // 未対応ブロックタイプの場合
+        return `${indent}<!-- Unsupported block type: ${block.type} -->`;
+    }
+    switch (block.type) {
+        case 'paragraph': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            return text ? `${indent}${text}` : '';
+        }
+        case 'heading_1': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            return `${indent}# ${text}`;
+        }
+        case 'heading_2': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            return `${indent}## ${text}`;
+        }
+        case 'heading_3': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            return `${indent}### ${text}`;
+        }
+        case 'bulleted_list_item': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            let result = `${indent}- ${text}`;
+            // 子ブロックがある場合
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                const childMarkdown = await blocksToMarkdown(children, {
+                    ...options,
+                    indentLevel: (options.indentLevel ?? 0) + 1,
+                });
+                if (childMarkdown) {
+                    result += `\n${childMarkdown}`;
+                }
+            }
+            return result;
+        }
+        case 'numbered_list_item': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            const index = options.listIndex ?? 1;
+            let result = `${indent}${index}. ${text}`;
+            // 子ブロックがある場合
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                const childMarkdown = await blocksToMarkdown(children, {
+                    ...options,
+                    indentLevel: (options.indentLevel ?? 0) + 1,
+                });
+                if (childMarkdown) {
+                    result += `\n${childMarkdown}`;
+                }
+            }
+            return result;
+        }
+        case 'to_do': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            const checked = blockData?.checked ? 'x' : ' ';
+            return `${indent}- [${checked}] ${text}`;
+        }
+        case 'toggle': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            let result = `${indent}<details>\n${indent}<summary>${text}</summary>\n`;
+            // 子ブロックがある場合
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                const childMarkdown = await blocksToMarkdown(children, {
+                    ...options,
+                    indentLevel: (options.indentLevel ?? 0) + 1,
+                });
+                if (childMarkdown) {
+                    result += `\n${childMarkdown}\n`;
+                }
+            }
+            result += `${indent}</details>`;
+            return result;
+        }
+        case 'code': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            const language = blockData?.language || '';
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            let result = `${indent}\`\`\`${language}\n${text}\n${indent}\`\`\``;
+            if (caption) {
+                result += `\n${indent}*${caption}*`;
+            }
+            return result;
+        }
+        case 'quote': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            // 複数行の場合は各行に > を付ける
+            const lines = text.split('\n');
+            return lines.map((line) => `${indent}> ${line}`).join('\n');
+        }
+        case 'callout': {
+            const text = richTextToMarkdown(blockData?.rich_text);
+            const icon = extractIconText(blockData?.icon);
+            const prefix = icon ? `${icon} ` : '';
+            return `${indent}> ${prefix}**Note:** ${text}`;
+        }
+        case 'divider': {
+            return `${indent}---`;
+        }
+        case 'bookmark': {
+            const url = blockData?.url || '';
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            const displayText = caption || url;
+            return `${indent}[${displayText}](${url})`;
+        }
+        case 'image': {
+            const url = extractFileUrl(blockData);
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            return `${indent}![${caption}](${url})`;
+        }
+        case 'video': {
+            const url = extractFileUrl(blockData);
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            const displayText = caption || 'Video';
+            return `${indent}[${displayText}](${url})`;
+        }
+        case 'audio': {
+            const url = extractFileUrl(blockData);
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            const displayText = caption || 'Audio';
+            return `${indent}[${displayText}](${url})`;
+        }
+        case 'file':
+        case 'pdf': {
+            const url = extractFileUrl(blockData);
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            const name = blockData?.name || caption || 'File';
+            return `${indent}[${name}](${url})`;
+        }
+        case 'embed': {
+            const url = blockData?.url || '';
+            const caption = blockData?.caption
+                ? richTextToMarkdown(blockData.caption)
+                : '';
+            const displayText = caption || 'Embed';
+            return `${indent}[${displayText}](${url})`;
+        }
+        case 'table_of_contents': {
+            return `${indent}[TOC]`;
+        }
+        case 'equation': {
+            const expression = blockData?.expression || '';
+            return `${indent}$$\n${expression}\n$$`;
+        }
+        case 'child_page': {
+            const title = blockData?.title || 'Untitled';
+            return `${indent}📄 [${title}]`;
+        }
+        case 'child_database': {
+            const title = blockData?.title || 'Untitled Database';
+            return `${indent}📊 [${title}]`;
+        }
+        case 'link_preview': {
+            const url = blockData?.url || '';
+            return `${indent}[${url}](${url})`;
+        }
+        case 'synced_block': {
+            // 同期ブロックの内容は子ブロックとして取得される
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                return await blocksToMarkdown(children, options);
+            }
+            return '';
+        }
+        case 'column_list': {
+            // カラムリストは子ブロック（column）として処理
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                const columnContents = [];
+                for (const column of children) {
+                    if (column.type === 'column' && column.has_children && options.fetchChildren) {
+                        const columnChildren = await options.fetchChildren(column.id);
+                        const content = await blocksToMarkdown(columnChildren, options);
+                        if (content) {
+                            columnContents.push(content);
+                        }
+                    }
+                }
+                // カラムを | で区切って表示
+                return columnContents.join('\n\n---\n\n');
+            }
+            return '';
+        }
+        case 'column': {
+            // column自体は直接変換しない（column_listで処理）
+            return '';
+        }
+        case 'table': {
+            // テーブルは子ブロック（table_row）として処理
+            if (block.has_children && options.fetchChildren && block.id) {
+                const children = await options.fetchChildren(block.id);
+                const rows = [];
+                const hasColumnHeader = blockData?.has_column_header;
+                for (let i = 0; i < children.length; i++) {
+                    const row = children[i];
+                    if (row.type === 'table_row') {
+                        const rowData = row.table_row;
+                        const cells = rowData?.cells || [];
+                        const cellTexts = cells.map((cell) => richTextToMarkdown(cell));
+                        rows.push(`${indent}| ${cellTexts.join(' | ')} |`);
+                        // ヘッダー行の後にセパレーターを追加
+                        if (i === 0 && hasColumnHeader) {
+                            const separator = cells.map(() => '---').join(' | ');
+                            rows.push(`${indent}| ${separator} |`);
+                        }
+                    }
+                }
+                return rows.join('\n');
+            }
+            return '';
+        }
+        case 'table_row': {
+            // table_rowは直接変換しない（tableで処理）
+            return '';
+        }
+        case 'breadcrumb': {
+            return `${indent}<!-- Breadcrumb -->`;
+        }
+        case 'template': {
+            // テンプレートブロックは非推奨
+            return `${indent}<!-- Template block -->`;
+        }
+        default: {
+            // 未対応ブロックタイプ
+            return `${indent}<!-- Unsupported block type: ${block.type} -->`;
+        }
+    }
+}
+/**
+ * ブロック配列をマークダウン文字列に変換
+ * @param blocks - Notion APIから取得したブロック配列
+ * @param options - 変換オプション
+ * @returns マークダウン文字列
+ */
+export async function blocksToMarkdown(blocks, options = {}) {
+    if (!blocks || blocks.length === 0) {
+        return '';
+    }
+    const lines = [];
+    let numberedListIndex = 1;
+    for (const block of blocks) {
+        // 番号付きリストのインデックス管理
+        const isNumberedList = block.type === 'numbered_list_item';
+        const currentOptions = {
+            ...options,
+            listIndex: isNumberedList ? numberedListIndex : undefined,
+        };
+        const markdown = await convertBlock(block, currentOptions);
+        // 番号付きリストのインデックスをインクリメント
+        if (isNumberedList) {
+            numberedListIndex++;
+        }
+        else {
+            numberedListIndex = 1; // リセット
+        }
+        // 空でない結果のみ追加
+        if (markdown) {
+            lines.push(markdown);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * ブロック配列をマークダウン文字列に変換（同期版、子ブロック取得なし）
+ * @param blocks - Notion APIから取得したブロック配列
+ * @returns マークダウン文字列
+ */
+export function blocksToMarkdownSync(blocks) {
+    if (!blocks || blocks.length === 0) {
+        return '';
+    }
+    const lines = [];
+    let numberedListIndex = 1;
+    for (const block of blocks) {
+        const indent = '';
+        const blockData = block[block.type];
+        let markdown = '';
+        switch (block.type) {
+            case 'paragraph': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = text ? `${indent}${text}` : '';
+                break;
+            }
+            case 'heading_1': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}# ${text}`;
+                break;
+            }
+            case 'heading_2': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}## ${text}`;
+                break;
+            }
+            case 'heading_3': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}### ${text}`;
+                break;
+            }
+            case 'bulleted_list_item': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}- ${text}`;
+                break;
+            }
+            case 'numbered_list_item': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}${numberedListIndex}. ${text}`;
+                numberedListIndex++;
+                break;
+            }
+            case 'to_do': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                const checked = blockData?.checked ? 'x' : ' ';
+                markdown = `${indent}- [${checked}] ${text}`;
+                break;
+            }
+            case 'toggle': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                markdown = `${indent}<details>\n${indent}<summary>${text}</summary>\n${indent}</details>`;
+                break;
+            }
+            case 'code': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                const language = blockData?.language || '';
+                markdown = `${indent}\`\`\`${language}\n${text}\n${indent}\`\`\``;
+                break;
+            }
+            case 'quote': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                const lines = text.split('\n');
+                markdown = lines.map((line) => `${indent}> ${line}`).join('\n');
+                break;
+            }
+            case 'callout': {
+                const text = richTextToMarkdown(blockData?.rich_text);
+                const icon = extractIconText(blockData?.icon);
+                const prefix = icon ? `${icon} ` : '';
+                markdown = `${indent}> ${prefix}**Note:** ${text}`;
+                break;
+            }
+            case 'divider': {
+                markdown = `${indent}---`;
+                break;
+            }
+            case 'bookmark': {
+                const url = blockData?.url || '';
+                const caption = blockData?.caption
+                    ? richTextToMarkdown(blockData.caption)
+                    : '';
+                const displayText = caption || url;
+                markdown = `${indent}[${displayText}](${url})`;
+                break;
+            }
+            case 'image': {
+                const url = extractFileUrl(blockData);
+                const caption = blockData?.caption
+                    ? richTextToMarkdown(blockData.caption)
+                    : '';
+                markdown = `${indent}![${caption}](${url})`;
+                break;
+            }
+            case 'video':
+            case 'audio': {
+                const url = extractFileUrl(blockData);
+                const caption = blockData?.caption
+                    ? richTextToMarkdown(blockData.caption)
+                    : '';
+                const displayText = caption || (block.type === 'video' ? 'Video' : 'Audio');
+                markdown = `${indent}[${displayText}](${url})`;
+                break;
+            }
+            case 'file':
+            case 'pdf': {
+                const url = extractFileUrl(blockData);
+                const caption = blockData?.caption
+                    ? richTextToMarkdown(blockData.caption)
+                    : '';
+                const name = blockData?.name || caption || 'File';
+                markdown = `${indent}[${name}](${url})`;
+                break;
+            }
+            case 'embed': {
+                const url = blockData?.url || '';
+                const caption = blockData?.caption
+                    ? richTextToMarkdown(blockData.caption)
+                    : '';
+                const displayText = caption || 'Embed';
+                markdown = `${indent}[${displayText}](${url})`;
+                break;
+            }
+            case 'table_of_contents': {
+                markdown = `${indent}[TOC]`;
+                break;
+            }
+            case 'equation': {
+                const expression = blockData?.expression || '';
+                markdown = `${indent}$$\n${expression}\n$$`;
+                break;
+            }
+            case 'child_page': {
+                const title = blockData?.title || 'Untitled';
+                markdown = `${indent}📄 [${title}]`;
+                break;
+            }
+            case 'child_database': {
+                const title = blockData?.title || 'Untitled Database';
+                markdown = `${indent}📊 [${title}]`;
+                break;
+            }
+            case 'link_preview': {
+                const url = blockData?.url || '';
+                markdown = `${indent}[${url}](${url})`;
+                break;
+            }
+            default: {
+                if (blockData) {
+                    markdown = `${indent}<!-- Unsupported block type: ${block.type} -->`;
+                }
+                break;
+            }
+        }
+        // 番号付きリスト以外の場合はインデックスをリセット
+        if (block.type !== 'numbered_list_item') {
+            numberedListIndex = 1;
+        }
+        if (markdown) {
+            lines.push(markdown);
+        }
+    }
+    return lines.join('\n');
+}

package/dist/src/converters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Notion データ変換モジュール
+ *
+ * Notion APIから取得したデータをマークダウンやシンプルな形式に変換する機能を提供
+ */
+export { blocksToMarkdown, blocksToMarkdownSync, type ConvertOptions, type NotionBlock, } from './block-to-markdown.js';
+export { type NotionProperty, type PropertyValue, pagePropertiesToObject, pagePropertiesToSimple, pagesToSimple, pageToSimple, type SimplePage, type SimpleProperty, } from './page-to-markdown.js';
+export { type RichTextItem, richTextToMarkdown, richTextToPlain, } from './rich-text-to-markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,KAAK,YAAY,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,4BAA4B,CAAA"}

package/dist/src/converters/index.js

@@ -0,0 +1,11 @@
+/**
+ * Notion データ変換モジュール
+ *
+ * Notion APIから取得したデータをマークダウンやシンプルな形式に変換する機能を提供
+ */
+// ブロック変換
+export { blocksToMarkdown, blocksToMarkdownSync, } from './block-to-markdown.js';
+// ページプロパティ変換
+export { pagePropertiesToObject, pagePropertiesToSimple, pagesToSimple, pageToSimple, } from './page-to-markdown.js';
+// RichText変換
+export { richTextToMarkdown, richTextToPlain, } from './rich-text-to-markdown.js';

package/dist/src/converters/page-to-markdown.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Notionページプロパティをシンプルな形式に変換するモジュール
+ */
+/**
+ * シンプル化されたプロパティの型
+ */
+export interface SimpleProperty {
+    name: string;
+    type: string;
+    value: PropertyValue;
+}
+/**
+ * プロパティ値の型
+ */
+export type PropertyValue = string | number | boolean | string[] | null | Record<string, unknown>;
+/**
+ * Notionプロパティオブジェクトの型
+ */
+export interface NotionProperty {
+    id?: string;
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * ページプロパティをシンプルな形式に変換
+ * @param properties - Notion APIから取得したプロパティオブジェクト
+ * @returns シンプル化されたプロパティの配列
+ */
+export declare function pagePropertiesToSimple(properties: Record<string, NotionProperty>): SimpleProperty[];
+/**
+ * ページプロパティをオブジェクト形式に変換（キー: プロパティ名、値: 値）
+ * @param properties - Notion APIから取得したプロパティオブジェクト
+ * @returns シンプル化されたプロパティオブジェクト
+ */
+export declare function pagePropertiesToObject(properties: Record<string, NotionProperty>): Record<string, PropertyValue>;
+/**
+ * シンプル化されたページオブジェクトの型
+ */
+export interface SimplePage {
+    id: string;
+    url: string;
+    properties: Record<string, PropertyValue>;
+}
+/**
+ * ページオブジェクトをシンプルな形式に変換
+ * @param page - Notion APIから取得したページオブジェクト
+ * @returns シンプル化されたページオブジェクト
+ */
+export declare function pageToSimple(page: {
+    id: string;
+    url?: string;
+    properties: Record<string, NotionProperty>;
+}): SimplePage;
+/**
+ * ページ配列をシンプルな形式に変換
+ * @param pages - Notion APIから取得したページ配列
+ * @returns シンプル化されたページ配列
+ */
+export declare function pagesToSimple(pages: {
+    id: string;
+    url?: string;
+    properties: Record<string, NotionProperty>;
+}[]): SimplePage[];
+//# sourceMappingURL=page-to-markdown.d.ts.map

package/dist/src/converters/page-to-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-to-markdown.d.ts","sourceRoot":"","sources":["../../../src/converters/page-to-markdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAwKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACzC,cAAc,EAAE,CAUlB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAU/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAC3C,GAAG,UAAU,CAMb;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAAE,EAAE,GAChF,UAAU,EAAE,CAKd"}