@atikk-co-jp/notion-mcp-server 0.2.3 → 0.3.0

package/README.ja.md

@@ -14,6 +14,7 @@ Notion API用のMCP（Model Context Protocol）サーバー。AIアシスタン
 - **検索**: ページとデータベースの横断検索
 - **コメント**: ページへのコメント追加
 - **トークン効率化**: マークダウン/シンプル形式でトークン使用量を約96%削減
+- **Markdown入力対応**: Markdownでコンテンツを作成・追加（出力トークン80%削減）
 
 ## インストール
 
@@ -110,6 +111,45 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
 }
 ```
 
+### create-page-simple ⭐
+
+Markdownを使ってページを作成します。`create-page`と比較して**出力トークン約80%削減**。
+
+**パラメータ:**
+- `database_id` (必須): ページを作成するデータベースのID
+- `title` (必須): ページタイトル（文字列）
+- `content` (任意): ページ本文（Markdown形式）
+- `properties` (任意): 追加のNotionプロパティ
+- `icon` (任意): 絵文字アイコン（例: "🐛"）
+
+**サポートするMarkdown記法:**
+- 見出し: `# ## ###` (####以上はheading_3にフォールバック)
+- リスト: `- ` または `* ` (箇条書き)、`1. ` (番号付き)
+- チェックボックス: `- [ ]` / `- [x]`
+- コードブロック: ` ``` ` (言語指定対応)
+- 引用: `> `
+- 区切り線: `---`
+- 画像: `![alt](url)`
+- インライン: `**太字**`、`*イタリック*`、`~~取り消し線~~`、`` `コード` ``、`[リンク](url)`
+
+```json
+{
+  "database_id": "データベースのUUID",
+  "title": "バグレポート",
+  "content": "## 再現手順\n\n1. ログイン\n2. 設定を開く\n\n## 期待動作\n\n正常に表示される",
+  "properties": {
+    "Status": { "status": { "name": "Open" } }
+  },
+  "icon": "🐛"
+}
+```
+
+**トークン比較:**
+| 方式 | トークン数 | 削減率 |
+|------|-----------|--------|
+| create-page (ブロック構造) | ~152 | - |
+| create-page-simple (Markdown) | ~26 | **83%** |
+
 ### update-page
 
 ページのプロパティを更新します。
@@ -250,6 +290,30 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
 }
 ```
 
+### append-blocks-simple ⭐
+
+Markdownを使ってブロックを追加します。`append-block-children`と比較して**出力トークン約80%削減**。
+
+**パラメータ:**
+- `block_id` (必須): 追加先のページまたはブロックのID
+- `content` (必須): 追加するコンテンツ（Markdown形式）
+- `after` (任意): このブロックIDの後に挿入
+
+`create-page-simple`と同じMarkdown記法をサポートしています。
+
+```json
+{
+  "block_id": "ページまたはブロックのUUID",
+  "content": "# 新しいセクション\n\nこれは**重要な**コンテンツで[リンク](https://example.com)もあります。\n\n- 項目1\n- 項目2\n\n```javascript\nconst x = 1;\n```"
+}
+```
+
+**トークン比較:**
+| 方式 | トークン数 | 削減率 |
+|------|-----------|--------|
+| append-block-children (ブロック構造) | ~201 | - |
+| append-blocks-simple (Markdown) | ~42 | **79%** |
+
 ### create-comment
 
 ページにコメントを追加します。

package/README.md

@@ -14,6 +14,7 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 - **Search**: Search across pages and databases
 - **Comments**: Add comments to pages
 - **Token-Efficient Output**: Markdown/simple format reduces token usage by ~96%
+- **Markdown Input**: Create and append content using Markdown (80% fewer output tokens)
 
 ## Installation
 
@@ -110,6 +111,45 @@ Create a new page in a database.
 }
 ```
 
+### create-page-simple ⭐
+
+Create a new page using Markdown. **~80% fewer output tokens** compared to `create-page`.
+
+**Parameters:**
+- `database_id` (required): The database ID to create the page in
+- `title` (required): Page title as a simple string
+- `content` (optional): Page content in Markdown
+- `properties` (optional): Additional Notion properties
+- `icon` (optional): Emoji icon (e.g., "🐛")
+
+**Supported Markdown:**
+- Headings: `# ## ###` (#### and beyond → heading_3)
+- Lists: `- ` or `* ` (bulleted), `1. ` (numbered)
+- Checkboxes: `- [ ]` / `- [x]`
+- Code blocks: ` ``` ` with language
+- Quotes: `> `
+- Dividers: `---`
+- Images: `![alt](url)`
+- Inline: `**bold**`, `*italic*`, `~~strike~~`, `` `code` ``, `[link](url)`
+
+```json
+{
+  "database_id": "database-uuid-here",
+  "title": "Bug Report",
+  "content": "## Steps to Reproduce\n\n1. Login\n2. Open settings\n\n## Expected Behavior\n\nShould display correctly",
+  "properties": {
+    "Status": { "status": { "name": "Open" } }
+  },
+  "icon": "🐛"
+}
+```
+
+**Token Comparison:**
+| Method | Tokens | Reduction |
+|--------|--------|-----------|
+| create-page (blocks) | ~152 | - |
+| create-page-simple (markdown) | ~26 | **83%** |
+
 ### update-page
 
 Update a page's properties.
@@ -250,6 +290,30 @@ Append new blocks to a page or block.
 }
 ```
 
+### append-blocks-simple ⭐
+
+Append blocks using Markdown. **~80% fewer output tokens** compared to `append-block-children`.
+
+**Parameters:**
+- `block_id` (required): The page or block ID to append to
+- `content` (required): Content in Markdown
+- `after` (optional): Insert after this block ID
+
+Same Markdown support as `create-page-simple`.
+
+```json
+{
+  "block_id": "page-or-block-uuid-here",
+  "content": "# New Section\n\nThis is **important** content with a [link](https://example.com).\n\n- Item 1\n- Item 2\n\n```javascript\nconst x = 1;\n```"
+}
+```
+
+**Token Comparison:**
+| Method | Tokens | Reduction |
+|--------|--------|-----------|
+| append-block-children (blocks) | ~201 | - |
+| append-blocks-simple (markdown) | ~42 | **79%** |
+
 ### create-comment
 
 Add a comment to a page.

package/dist/src/converters/__tests__/markdown-to-blocks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdown-to-blocks.test.d.ts.map

package/dist/src/converters/__tests__/markdown-to-blocks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-to-blocks.test.d.ts","sourceRoot":"","sources":["../../../../src/converters/__tests__/markdown-to-blocks.test.ts"],"names":[],"mappings":""}

package/dist/src/converters/__tests__/markdown-to-blocks.test.js

@@ -0,0 +1,245 @@
+import { describe, expect, it } from 'vitest';
+import { markdownToBlocks, parseInlineMarkdown } from '../markdown-to-blocks.js';
+describe('parseInlineMarkdown', () => {
+    describe('plain text', () => {
+        it('should return plain text as single rich text item', () => {
+            const result = parseInlineMarkdown('Hello world');
+            expect(result).toEqual([{ type: 'text', text: { content: 'Hello world' } }]);
+        });
+        it('should handle empty string', () => {
+            const result = parseInlineMarkdown('');
+            expect(result).toEqual([]);
+        });
+    });
+    describe('bold', () => {
+        it('should parse **bold** text', () => {
+            const result = parseInlineMarkdown('This is **bold** text');
+            expect(result).toHaveLength(3);
+            expect(result[0]).toEqual({ type: 'text', text: { content: 'This is ' } });
+            expect(result[1]).toEqual({
+                type: 'text',
+                text: { content: 'bold' },
+                annotations: { bold: true },
+            });
+            expect(result[2]).toEqual({ type: 'text', text: { content: ' text' } });
+        });
+    });
+    describe('italic', () => {
+        it('should parse *italic* text', () => {
+            const result = parseInlineMarkdown('This is *italic* text');
+            expect(result).toHaveLength(3);
+            expect(result[1]).toEqual({
+                type: 'text',
+                text: { content: 'italic' },
+                annotations: { italic: true },
+            });
+        });
+    });
+    describe('strikethrough', () => {
+        it('should parse ~~strikethrough~~ text', () => {
+            const result = parseInlineMarkdown('This is ~~deleted~~ text');
+            expect(result).toHaveLength(3);
+            expect(result[1]).toEqual({
+                type: 'text',
+                text: { content: 'deleted' },
+                annotations: { strikethrough: true },
+            });
+        });
+    });
+    describe('code', () => {
+        it('should parse `code` text', () => {
+            const result = parseInlineMarkdown('Use `console.log()` here');
+            expect(result).toHaveLength(3);
+            expect(result[1]).toEqual({
+                type: 'text',
+                text: { content: 'console.log()' },
+                annotations: { code: true },
+            });
+        });
+    });
+    describe('links', () => {
+        it('should parse [text](url) links', () => {
+            const result = parseInlineMarkdown('Visit [Google](https://google.com) now');
+            expect(result).toHaveLength(3);
+            expect(result[1]).toEqual({
+                type: 'text',
+                text: { content: 'Google', link: { url: 'https://google.com' } },
+                annotations: {},
+            });
+        });
+    });
+});
+describe('markdownToBlocks', () => {
+    describe('paragraphs', () => {
+        it('should convert plain text to paragraph block', () => {
+            const result = markdownToBlocks('Hello world');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('paragraph');
+            expect(result[0].paragraph).toEqual({
+                rich_text: [{ type: 'text', text: { content: 'Hello world' } }],
+            });
+        });
+        it('should skip empty lines', () => {
+            const result = markdownToBlocks('Line 1\n\nLine 2');
+            expect(result).toHaveLength(2);
+            expect(result[0].type).toBe('paragraph');
+            expect(result[1].type).toBe('paragraph');
+        });
+    });
+    describe('headings', () => {
+        it('should convert # to heading_1', () => {
+            const result = markdownToBlocks('# Heading 1');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('heading_1');
+            expect(result[0].heading_1).toEqual({
+                rich_text: [{ type: 'text', text: { content: 'Heading 1' } }],
+            });
+        });
+        it('should convert ## to heading_2', () => {
+            const result = markdownToBlocks('## Heading 2');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('heading_2');
+        });
+        it('should convert ### to heading_3', () => {
+            const result = markdownToBlocks('### Heading 3');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('heading_3');
+        });
+    });
+    describe('lists', () => {
+        it('should convert - to bulleted_list_item', () => {
+            const result = markdownToBlocks('- Item 1\n- Item 2');
+            expect(result).toHaveLength(2);
+            expect(result[0].type).toBe('bulleted_list_item');
+            expect(result[1].type).toBe('bulleted_list_item');
+        });
+        it('should convert * to bulleted_list_item', () => {
+            const result = markdownToBlocks('* Item 1');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('bulleted_list_item');
+        });
+        it('should convert 1. to numbered_list_item', () => {
+            const result = markdownToBlocks('1. First\n2. Second');
+            expect(result).toHaveLength(2);
+            expect(result[0].type).toBe('numbered_list_item');
+            expect(result[1].type).toBe('numbered_list_item');
+        });
+    });
+    describe('checkboxes', () => {
+        it('should convert - [ ] to unchecked to_do', () => {
+            const result = markdownToBlocks('- [ ] Task');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('to_do');
+            expect(result[0].to_do).toEqual({
+                rich_text: [{ type: 'text', text: { content: 'Task' } }],
+                checked: false,
+            });
+        });
+        it('should convert - [x] to checked to_do', () => {
+            const result = markdownToBlocks('- [x] Done');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('to_do');
+            expect(result[0].to_do.checked).toBe(true);
+        });
+        it('should handle - [X] (uppercase)', () => {
+            const result = markdownToBlocks('- [X] Done');
+            expect(result[0].to_do.checked).toBe(true);
+        });
+    });
+    describe('code blocks', () => {
+        it('should convert ``` to code block', () => {
+            const result = markdownToBlocks('```\nconst x = 1\n```');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('code');
+            expect(result[0].code).toEqual({
+                rich_text: [{ type: 'text', text: { content: 'const x = 1' } }],
+                language: 'plain text',
+            });
+        });
+        it('should parse language from code fence', () => {
+            const result = markdownToBlocks('```typescript\nconst x: number = 1\n```');
+            expect(result[0].code.language).toBe('typescript');
+        });
+        it('should handle multi-line code', () => {
+            const result = markdownToBlocks('```js\nline1\nline2\nline3\n```');
+            const code = result[0].code;
+            expect(code.rich_text[0].text.content).toBe('line1\nline2\nline3');
+        });
+    });
+    describe('quotes', () => {
+        it('should convert > to quote block', () => {
+            const result = markdownToBlocks('> This is a quote');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('quote');
+            expect(result[0].quote).toEqual({
+                rich_text: [{ type: 'text', text: { content: 'This is a quote' } }],
+            });
+        });
+        it('should combine consecutive quote lines', () => {
+            const result = markdownToBlocks('> Line 1\n> Line 2');
+            expect(result).toHaveLength(1);
+            const quote = result[0].quote;
+            expect(quote.rich_text[0].text.content).toBe('Line 1\nLine 2');
+        });
+    });
+    describe('dividers', () => {
+        it('should convert --- to divider', () => {
+            const result = markdownToBlocks('---');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('divider');
+            expect(result[0].divider).toEqual({});
+        });
+        it('should handle ---- (multiple dashes)', () => {
+            const result = markdownToBlocks('----');
+            expect(result[0].type).toBe('divider');
+        });
+    });
+    describe('images', () => {
+        it('should convert ![alt](url) to image block', () => {
+            const result = markdownToBlocks('![Alt text](https://example.com/image.png)');
+            expect(result).toHaveLength(1);
+            expect(result[0].type).toBe('image');
+            expect(result[0].image).toEqual({
+                type: 'external',
+                external: { url: 'https://example.com/image.png' },
+                caption: [{ type: 'text', text: { content: 'Alt text' } }],
+            });
+        });
+        it('should handle image without alt text', () => {
+            const result = markdownToBlocks('![](https://example.com/image.png)');
+            expect(result[0].image.caption).toEqual([]);
+        });
+    });
+    describe('mixed content', () => {
+        it('should handle complex markdown document', () => {
+            const markdown = `# Title
+
+This is a paragraph with **bold** and *italic*.
+
+## Section
+
+- Item 1
+- Item 2
+
+\`\`\`javascript
+const x = 1
+\`\`\`
+
+> A quote
+
+---
+
+![Image](https://example.com/img.png)`;
+            const result = markdownToBlocks(markdown);
+            expect(result[0].type).toBe('heading_1');
+            expect(result[1].type).toBe('paragraph');
+            expect(result[2].type).toBe('heading_2');
+            expect(result[3].type).toBe('bulleted_list_item');
+            expect(result[4].type).toBe('bulleted_list_item');
+            expect(result[5].type).toBe('code');
+            expect(result[6].type).toBe('quote');
+            expect(result[7].type).toBe('divider');
+            expect(result[8].type).toBe('image');
+        });
+    });
+});

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

@@ -6,4 +6,5 @@
 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';
+export { markdownToBlocks, parseInlineMarkdown } from './markdown-to-blocks.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAEnC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/src/converters/index.js

@@ -9,3 +9,5 @@ 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';
+// Markdown→ブロック変換
+export { markdownToBlocks, parseInlineMarkdown } from './markdown-to-blocks.js';

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

@@ -0,0 +1,21 @@
+/**
+ * Markdown文字列をNotionブロック配列に変換するモジュール
+ */
+import type { RichTextItem } from './rich-text-to-markdown.js';
+/**
+ * Notionブロックの型定義（簡易版）
+ */
+export interface NotionBlock {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * インラインMarkdown記法をRichText配列に変換
+ * サポート: **bold**, *italic*, ~~strike~~, `code`, [text](url)
+ */
+export declare function parseInlineMarkdown(text: string): RichTextItem[];
+/**
+ * Markdown文字列をNotionブロック配列に変換
+ */
+export declare function markdownToBlocks(markdown: string): NotionBlock[];
+//# sourceMappingURL=markdown-to-blocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-to-blocks.d.ts","sourceRoot":"","sources":["../../../src/converters/markdown-to-blocks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAO9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8HhE;AAmBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA2HhE"}

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

@@ -0,0 +1,244 @@
+/**
+ * Markdown文字列をNotionブロック配列に変換するモジュール
+ */
+// 安全性のための制限値
+const MAX_INPUT_LENGTH = 100_000; // 100KB
+const MAX_LINE_LENGTH = 10_000; // 10KB per line
+const MAX_CODE_BLOCK_LINES = 1000;
+/**
+ * インラインMarkdown記法をRichText配列に変換
+ * サポート: **bold**, *italic*, ~~strike~~, `code`, [text](url)
+ */
+export function parseInlineMarkdown(text) {
+    // 行長制限（ReDoS対策）
+    const safeText = text.length > MAX_LINE_LENGTH ? text.slice(0, MAX_LINE_LENGTH) : text;
+    const result = [];
+    // 正規表現パターン（優先順位順）
+    const patterns = [
+        // リンク: [text](url)
+        { regex: /\[([^\]]+)\]\(([^)]+)\)/g, type: 'link' },
+        // 太字: **text**
+        { regex: /\*\*([^*]+)\*\*/g, type: 'bold' },
+        // イタリック: *text* (太字でないもの)
+        { regex: /(?<!\*)\*([^*]+)\*(?!\*)/g, type: 'italic' },
+        // 取り消し線: ~~text~~
+        { regex: /~~([^~]+)~~/g, type: 'strikethrough' },
+        // インラインコード: `code`
+        { regex: /`([^`]+)`/g, type: 'code' },
+    ];
+    // 単純な実装: マークダウン記法を順番に処理
+    // 複雑なネストは非対応（Notion APIも完全なネストは非対応）
+    let lastIndex = 0;
+    // 全パターンをまとめて検索
+    const allMatches = [];
+    for (const { regex, type } of patterns) {
+        const re = new RegExp(regex.source, 'g');
+        let match = re.exec(safeText);
+        while (match !== null) {
+            allMatches.push({
+                index: match.index,
+                length: match[0].length,
+                content: match[1],
+                type,
+                url: type === 'link' ? match[2] : undefined,
+            });
+            match = re.exec(safeText);
+        }
+    }
+    // インデックス順にソート
+    allMatches.sort((a, b) => a.index - b.index);
+    // 重複を除去（先に来たものを優先）
+    const filteredMatches = [];
+    let lastEnd = 0;
+    for (const m of allMatches) {
+        if (m.index >= lastEnd) {
+            filteredMatches.push(m);
+            lastEnd = m.index + m.length;
+        }
+    }
+    // RichText配列を構築
+    lastIndex = 0;
+    for (const match of filteredMatches) {
+        // マッチ前のプレーンテキスト
+        if (match.index > lastIndex) {
+            const plainText = safeText.slice(lastIndex, match.index);
+            if (plainText) {
+                result.push({
+                    type: 'text',
+                    text: { content: plainText },
+                });
+            }
+        }
+        // マッチしたテキスト
+        const richText = {
+            type: 'text',
+            text: { content: match.content },
+            annotations: {},
+        };
+        switch (match.type) {
+            case 'bold':
+                richText.annotations = { bold: true };
+                break;
+            case 'italic':
+                richText.annotations = { italic: true };
+                break;
+            case 'strikethrough':
+                richText.annotations = { strikethrough: true };
+                break;
+            case 'code':
+                richText.annotations = { code: true };
+                break;
+            case 'link':
+                if (match.url) {
+                    richText.text = { content: match.content, link: { url: match.url } };
+                }
+                break;
+        }
+        result.push(richText);
+        lastIndex = match.index + match.length;
+    }
+    // 残りのプレーンテキスト
+    if (lastIndex < safeText.length) {
+        const plainText = safeText.slice(lastIndex);
+        if (plainText) {
+            result.push({
+                type: 'text',
+                text: { content: plainText },
+            });
+        }
+    }
+    // 何もマッチしなかった場合
+    if (result.length === 0 && safeText) {
+        result.push({
+            type: 'text',
+            text: { content: safeText },
+        });
+    }
+    return result;
+}
+/**
+ * RichTextを含むブロックを生成するヘルパー
+ */
+function createTextBlock(type, text, extra = {}) {
+    return {
+        type,
+        [type]: {
+            rich_text: parseInlineMarkdown(text),
+            ...extra,
+        },
+    };
+}
+/**
+ * Markdown文字列をNotionブロック配列に変換
+ */
+export function markdownToBlocks(markdown) {
+    // 入力長制限（ReDoS対策）
+    const safeMarkdown = markdown.length > MAX_INPUT_LENGTH ? markdown.slice(0, MAX_INPUT_LENGTH) : markdown;
+    const blocks = [];
+    const lines = safeMarkdown.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // 空行はスキップ
+        if (!line.trim()) {
+            i++;
+            continue;
+        }
+        // コードブロック: ```language
+        if (line.startsWith('```')) {
+            const language = line.slice(3).trim() || 'plain text';
+            const codeLines = [];
+            i++;
+            while (i < lines.length && !lines[i].startsWith('```') && codeLines.length < MAX_CODE_BLOCK_LINES) {
+                codeLines.push(lines[i]);
+                i++;
+            }
+            // 残りの行をスキップ（制限超過時）
+            while (i < lines.length && !lines[i].startsWith('```')) {
+                i++;
+            }
+            blocks.push({
+                type: 'code',
+                code: {
+                    rich_text: [{ type: 'text', text: { content: codeLines.join('\n') } }],
+                    language,
+                },
+            });
+            i++; // closing ```
+            continue;
+        }
+        // 水平線: ---
+        if (/^-{3,}$/.test(line.trim())) {
+            blocks.push({ type: 'divider', divider: {} });
+            i++;
+            continue;
+        }
+        // 見出し: # ## ### (####以上はheading_3にフォールバック)
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            const rawLevel = headingMatch[1].length;
+            const level = Math.min(rawLevel, 3);
+            const text = headingMatch[2];
+            const type = `heading_${level}`;
+            blocks.push(createTextBlock(type, text));
+            i++;
+            continue;
+        }
+        // チェックボックス: - [ ] or - [x]
+        const todoMatch = line.match(/^-\s*\[([ xX])\]\s*(.*)$/);
+        if (todoMatch) {
+            const checked = todoMatch[1].toLowerCase() === 'x';
+            const text = todoMatch[2];
+            blocks.push(createTextBlock('to_do', text, { checked }));
+            i++;
+            continue;
+        }
+        // 箇条書き: - or *
+        const bulletMatch = line.match(/^[-*]\s+(.+)$/);
+        if (bulletMatch) {
+            blocks.push(createTextBlock('bulleted_list_item', bulletMatch[1]));
+            i++;
+            continue;
+        }
+        // 番号付きリスト: 1. 2. etc
+        const numberedMatch = line.match(/^\d+\.\s+(.+)$/);
+        if (numberedMatch) {
+            blocks.push(createTextBlock('numbered_list_item', numberedMatch[1]));
+            i++;
+            continue;
+        }
+        // 引用: >
+        const quoteMatch = line.match(/^>\s*(.*)$/);
+        if (quoteMatch) {
+            // 連続する引用行をまとめる
+            const quoteLines = [quoteMatch[1]];
+            i++;
+            while (i < lines.length && lines[i].startsWith('>')) {
+                quoteLines.push(lines[i].replace(/^>\s*/, ''));
+                i++;
+            }
+            blocks.push(createTextBlock('quote', quoteLines.join('\n')));
+            continue;
+        }
+        // 画像: ![alt](url)
+        const imageMatch = line.match(/^!\[([^\]]*)\]\(([^)]+)\)$/);
+        if (imageMatch) {
+            blocks.push({
+                type: 'image',
+                image: {
+                    type: 'external',
+                    external: { url: imageMatch[2] },
+                    caption: imageMatch[1]
+                        ? [{ type: 'text', text: { content: imageMatch[1] } }]
+                        : [],
+                },
+            });
+            i++;
+            continue;
+        }
+        // デフォルト: 段落
+        blocks.push(createTextBlock('paragraph', line));
+        i++;
+    }
+    return blocks;
+}

package/dist/src/tools/append-blocks-simple.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionClient } from '../notion-client.js';
+export declare function registerAppendBlocksSimple(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=append-blocks-simple.d.ts.map

package/dist/src/tools/append-blocks-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-blocks-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/append-blocks-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqCxF"}

package/dist/src/tools/append-blocks-simple.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { markdownToBlocks } from '../converters/index.js';
+import { formatResponse, handleError } from '../utils/index.js';
+// Minimal schema for MCP
+const inputSchema = {
+    block_id: z.string().describe('Page or block ID to append to'),
+    content: z.string().describe('Content in Markdown'),
+    after: z.string().optional().describe('Insert after this block ID'),
+};
+export function registerAppendBlocksSimple(server, notion) {
+    server.registerTool('append-blocks-simple', {
+        description: 'Append blocks to a page using Markdown. ' +
+            'Simpler than append-block-children: just provide markdown text. ' +
+            'Supports: headings (#), lists (- or 1.), checkboxes (- [ ]), code blocks (```), quotes (>), images (![]()), bold (**), italic (*), links ([]()), etc.',
+        inputSchema,
+    }, async ({ block_id, content, after }) => {
+        try {
+            // Convert markdown to blocks
+            const children = markdownToBlocks(content);
+            // Build params
+            const params = {
+                block_id,
+                children,
+            };
+            if (after) {
+                params.after = after;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const response = await notion.blocks.children.append(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

package/dist/src/tools/create-page-simple.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NotionClient } from '../notion-client.js';
+export declare function registerCreatePageSimple(server: McpServer, notion: NotionClient): void;
+//# sourceMappingURL=create-page-simple.d.ts.map

package/dist/src/tools/create-page-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-page-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAYvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA2DtF"}

package/dist/src/tools/create-page-simple.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { markdownToBlocks } from '../converters/index.js';
+import { formatResponse, handleError } from '../utils/index.js';
+// Minimal schema for MCP
+const inputSchema = {
+    database_id: z.string().describe('Database ID'),
+    title: z.string().describe('Page title'),
+    content: z.string().optional().describe('Page content in Markdown'),
+    properties: z.record(z.string(), z.any()).optional().describe('Additional properties'),
+    icon: z.string().optional().describe('Emoji icon (e.g. "bug")'),
+};
+export function registerCreatePageSimple(server, notion) {
+    server.registerTool('create-page-simple', {
+        description: 'Create a Notion page with Markdown content. ' +
+            'Simpler than create-page: just provide title and markdown text. ' +
+            'Supports: headings (#), lists (- or 1.), checkboxes (- [ ]), code blocks (```), quotes (>), images (![]()), bold (**), italic (*), links ([]()), etc.',
+        inputSchema,
+    }, async ({ database_id, title, content, properties, icon }) => {
+        try {
+            // Build properties with title
+            const pageProperties = {
+                ...properties,
+            };
+            // Check if any title property is already provided
+            // Title properties have the structure: { title: [...] }
+            const hasTitleProperty = Object.values(pageProperties).some((prop) => prop && typeof prop === 'object' && 'title' in prop);
+            // Only add Name if no title property exists
+            if (!hasTitleProperty) {
+                pageProperties.Name = {
+                    title: [{ type: 'text', text: { content: title } }],
+                };
+            }
+            // Build params
+            const params = {
+                parent: { database_id },
+                properties: pageProperties,
+            };
+            // Convert markdown to blocks if content provided
+            if (content) {
+                params.children = markdownToBlocks(content);
+            }
+            // Add icon if provided
+            if (icon) {
+                params.icon = { type: 'emoji', emoji: icon };
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const response = await notion.pages.create(params);
+            return formatResponse(response);
+        }
+        catch (error) {
+            return handleError(error);
+        }
+    });
+}

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

@@ -1,9 +1,11 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { NotionClient } from '../notion-client.js';
 import { registerAppendBlockChildren } from './append-block-children.js';
+import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerCreateComment } from './create-comment.js';
 import { registerCreateDatabase } from './create-database.js';
 import { registerCreatePage } from './create-page.js';
+import { registerCreatePageSimple } from './create-page-simple.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerQueryDatabase } from './query-database.js';
 import { registerRetrievePage } from './retrieve-page.js';
@@ -11,5 +13,5 @@ import { registerSearch } from './search.js';
 import { registerUpdateDatabase } from './update-database.js';
 import { registerUpdatePage } from './update-page.js';
 export declare function registerAllTools(server: McpServer, notion: NotionClient): void;
-export { registerRetrievePage, registerCreatePage, registerUpdatePage, registerCreateDatabase, registerUpdateDatabase, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerCreateComment, };
+export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerCreateDatabase, registerUpdateDatabase, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerCreateComment, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoB9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,GACtB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsB9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,GACtB,CAAA"}

package/dist/src/tools/index.js

@@ -1,7 +1,9 @@
 import { registerAppendBlockChildren } from './append-block-children.js';
+import { registerAppendBlocksSimple } from './append-blocks-simple.js';
 import { registerCreateComment } from './create-comment.js';
 import { registerCreateDatabase } from './create-database.js';
 import { registerCreatePage } from './create-page.js';
+import { registerCreatePageSimple } from './create-page-simple.js';
 import { registerGetBlockChildren } from './get-block-children.js';
 import { registerQueryDatabase } from './query-database.js';
 import { registerRetrievePage } from './retrieve-page.js';
@@ -12,6 +14,7 @@ export function registerAllTools(server, notion) {
     // Page operations
     registerRetrievePage(server, notion);
     registerCreatePage(server, notion);
+    registerCreatePageSimple(server, notion);
     registerUpdatePage(server, notion);
     // Database operations
     registerCreateDatabase(server, notion);
@@ -22,7 +25,8 @@ export function registerAllTools(server, notion) {
     // Block operations
     registerGetBlockChildren(server, notion);
     registerAppendBlockChildren(server, notion);
+    registerAppendBlocksSimple(server, notion);
     // Comment operations
     registerCreateComment(server, notion);
 }
-export { registerRetrievePage, registerCreatePage, registerUpdatePage, registerCreateDatabase, registerUpdateDatabase, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerCreateComment, };
+export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerCreateDatabase, registerUpdateDatabase, registerQueryDatabase, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerCreateComment, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atikk-co-jp/notion-mcp-server",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "MCP server for Notion API - Create, read, update pages and databases",
   "type": "module",
   "license": "MIT",