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

package/README.ja.md

@@ -9,10 +9,11 @@ Notion API用のMCP（Model Context Protocol）サーバー。AIアシスタン
 ## 特徴
 
 - **ページ操作**: Notionページの作成、取得、更新
-- **データベースクエリ**: フィルターやソートを使ったデータベース検索
+- **データベース操作**: データベースの作成、更新、フィルター/ソートを使ったクエリ
 - **ブロック操作**: ブロックの子要素の取得と追加
 - **検索**: ページとデータベースの横断検索
 - **コメント**: ページへのコメント追加
+- **トークン効率化**: マークダウン/シンプル形式でトークン使用量を約96%削減
 
 ## インストール
 
@@ -76,9 +77,18 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
 
 ページIDでNotionページを取得します。
 
+**パラメータ:**
+- `page_id` (必須): 取得するページのID
+- `format` (任意): 出力形式 - `"simple"` (デフォルト) または `"json"`
+  - `simple`: トークン使用量を削減した簡略化されたプロパティ値を返す
+  - `json`: Notion APIのレスポンスをそのまま返す
+- `include_content` (任意): ページコンテンツをマークダウンで含める（デフォルト: true）
+
 ```json
 {
-  "page_id": "ページのUUID"
+  "page_id": "ページのUUID",
+  "format": "simple",
+  "include_content": true
 }
 ```
 
@@ -119,6 +129,16 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
 
 フィルターやソートを使ってデータベースをクエリします。
 
+**パラメータ:**
+- `database_id` (必須): クエリするデータベースのID
+- `filter` (任意): フィルター条件（JSONオブジェクト）
+- `sorts` (任意): ソート条件（配列）
+- `start_cursor` (任意): ページネーション用カーソル
+- `page_size` (任意): 返す結果の数 (1-100)
+- `format` (任意): 出力形式 - `"simple"` (デフォルト) または `"json"`
+  - `simple`: トークン使用量を削減した簡略化されたプロパティ値を返す
+  - `json`: Notion APIのレスポンスをそのまま返す
+
 ```json
 {
   "database_id": "データベースのUUID",
@@ -128,7 +148,55 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
   },
   "sorts": [
     { "property": "Created", "direction": "descending" }
-  ]
+  ],
+  "format": "simple"
+}
+```
+
+### create-database
+
+既存のページのサブページとして新しいデータベースを作成します。
+
+**パラメータ:**
+- `parent_page_id` (必須): 親ページのID
+- `properties` (必須): 少なくとも1つのtitleプロパティを含むデータベーススキーマ
+- `title` (任意): データベースタイトル（リッチテキスト配列）
+- `icon` (任意): データベースのアイコン
+- `cover` (任意): データベースのカバー画像
+- `is_inline` (任意): trueの場合、インラインデータベースとして作成
+
+```json
+{
+  "parent_page_id": "親ページのUUID",
+  "properties": {
+    "Name": { "title": {} },
+    "Status": { "select": { "options": [{ "name": "未着手" }, { "name": "完了" }] } },
+    "Priority": { "number": {} }
+  },
+  "title": [{ "type": "text", "text": { "content": "タスクデータベース" } }]
+}
+```
+
+### update-database
+
+既存のデータベースのプロパティ、タイトル、スキーマを更新します。
+
+**パラメータ:**
+- `database_id` (必須): 更新するデータベースのID
+- `title` (任意): 新しいタイトル（リッチテキスト配列）
+- `description` (任意): 新しい説明（リッチテキスト配列）
+- `properties` (任意): 追加、更新、削除するプロパティ（nullで削除）
+- `icon` (任意): アイコン（nullで削除）
+- `cover` (任意): カバー画像（nullで削除）
+- `archived` (任意): trueでアーカイブ
+
+```json
+{
+  "database_id": "データベースのUUID",
+  "properties": {
+    "NewColumn": { "rich_text": {} },
+    "OldColumn": null
+  }
 }
 ```
 
@@ -147,9 +215,20 @@ Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_d
 
 ページまたはブロックの子ブロックを取得します。
 
+**パラメータ:**
+- `block_id` (必須): 子ブロックを取得するブロックまたはページのID
+- `start_cursor` (任意): ページネーション用カーソル
+- `page_size` (任意): 返す結果の数 (1-100)
+- `format` (任意): 出力形式 - `"markdown"` (デフォルト) または `"json"`
+  - `markdown`: トークン使用量を大幅に削減（約96%削減）した人間が読みやすいマークダウン形式
+  - `json`: Notion APIのレスポンスをそのまま返す
+- `fetch_nested` (任意): `format="markdown"`の時、ネストされた子ブロックを再帰的に取得する（デフォルト: false）
+
 ```json
 {
-  "block_id": "ページまたはブロックのUUID"
+  "block_id": "ページまたはブロックのUUID",
+  "format": "markdown",
+  "fetch_nested": true
 }
 ```
 
@@ -196,6 +275,18 @@ pnpm build
 
 # 型チェック
 pnpm typecheck
+
+# リント
+pnpm lint
+
+# コードフォーマット
+pnpm format
+
+# テスト実行
+pnpm test
+
+# ウォッチモードでテスト実行
+pnpm test:watch
 ```
 
 ## ライセンス

package/README.md

@@ -9,10 +9,11 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
 ## Features
 
 - **Page Operations**: Create, retrieve, and update Notion pages
-- **Database Queries**: Query databases with filters and sorts
+- **Database Operations**: Create, update, and query databases with filters and sorts
 - **Block Operations**: Get and append block children
 - **Search**: Search across pages and databases
 - **Comments**: Add comments to pages
+- **Token-Efficient Output**: Markdown/simple format reduces token usage by ~96%
 
 ## Installation
 
@@ -76,9 +77,18 @@ Add to your `.mcp.json`:
 
 Retrieve a Notion page by its ID.
 
+**Parameters:**
+- `page_id` (required): The ID of the page to retrieve
+- `format` (optional): Output format - `"simple"` (default) or `"json"`
+  - `simple`: Returns simplified property values with reduced token usage
+  - `json`: Returns raw Notion API response
+- `include_content` (optional): Include page content as markdown (default: true)
+
 ```json
 {
-  "page_id": "page-uuid-here"
+  "page_id": "page-uuid-here",
+  "format": "simple",
+  "include_content": true
 }
 ```
 
@@ -119,6 +129,16 @@ Update a page's properties.
 
 Query a database with optional filters and sorts.
 
+**Parameters:**
+- `database_id` (required): The ID of the database to query
+- `filter` (optional): Filter conditions as a JSON object
+- `sorts` (optional): Sort conditions as an array
+- `start_cursor` (optional): Cursor for pagination
+- `page_size` (optional): Number of results to return (1-100)
+- `format` (optional): Output format - `"simple"` (default) or `"json"`
+  - `simple`: Returns simplified property values with reduced token usage
+  - `json`: Returns raw Notion API response
+
 ```json
 {
   "database_id": "database-uuid-here",
@@ -128,7 +148,55 @@ Query a database with optional filters and sorts.
   },
   "sorts": [
     { "property": "Created", "direction": "descending" }
-  ]
+  ],
+  "format": "simple"
+}
+```
+
+### create-database
+
+Create a new database as a subpage of an existing page.
+
+**Parameters:**
+- `parent_page_id` (required): The ID of the parent page
+- `properties` (required): Database schema with at least one title property
+- `title` (optional): Database title as rich text array
+- `icon` (optional): Icon for the database
+- `cover` (optional): Cover image for the database
+- `is_inline` (optional): If true, creates an inline database
+
+```json
+{
+  "parent_page_id": "parent-page-uuid",
+  "properties": {
+    "Name": { "title": {} },
+    "Status": { "select": { "options": [{ "name": "Todo" }, { "name": "Done" }] } },
+    "Priority": { "number": {} }
+  },
+  "title": [{ "type": "text", "text": { "content": "Task Database" } }]
+}
+```
+
+### update-database
+
+Update an existing database's properties, title, or schema.
+
+**Parameters:**
+- `database_id` (required): The ID of the database to update
+- `title` (optional): New title as rich text array
+- `description` (optional): New description as rich text array
+- `properties` (optional): Properties to add, update, or delete (set to null)
+- `icon` (optional): Icon (set to null to remove)
+- `cover` (optional): Cover image (set to null to remove)
+- `archived` (optional): Set to true to archive
+
+```json
+{
+  "database_id": "database-uuid-here",
+  "properties": {
+    "NewColumn": { "rich_text": {} },
+    "OldColumn": null
+  }
 }
 ```
 
@@ -147,9 +215,20 @@ Search across all pages and databases.
 
 Get the child blocks of a page or block.
 
+**Parameters:**
+- `block_id` (required): The ID of the block or page to get children from
+- `start_cursor` (optional): Cursor for pagination
+- `page_size` (optional): Number of results to return (1-100)
+- `format` (optional): Output format - `"markdown"` (default) or `"json"`
+  - `markdown`: Returns human-readable markdown with significantly reduced token usage (~96% reduction)
+  - `json`: Returns raw Notion API response
+- `fetch_nested` (optional): When `format="markdown"`, fetch nested children blocks recursively (default: false)
+
 ```json
 {
-  "block_id": "page-or-block-uuid-here"
+  "block_id": "page-or-block-uuid-here",
+  "format": "markdown",
+  "fetch_nested": true
 }
 ```
 
@@ -196,6 +275,18 @@ pnpm build
 
 # Type check
 pnpm typecheck
+
+# Lint
+pnpm lint
+
+# Format code
+pnpm format
+
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
 ```
 
 ## License

package/dist/bin/cli.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import { startServer } from "../src/server.js";
+import { startServer } from '../src/server.js';
 async function main() {
     // Validate environment
     if (!process.env.NOTION_TOKEN) {
-        console.error("Error: NOTION_TOKEN environment variable is required.");
-        console.error("");
-        console.error("To fix this:");
-        console.error("1. Create a Notion integration at https://www.notion.so/my-integrations");
-        console.error("2. Copy the Internal Integration Token");
-        console.error("3. Set it as NOTION_TOKEN environment variable");
-        console.error("");
-        console.error("Example:");
+        console.error('Error: NOTION_TOKEN environment variable is required.');
+        console.error('');
+        console.error('To fix this:');
+        console.error('1. Create a Notion integration at https://www.notion.so/my-integrations');
+        console.error('2. Copy the Internal Integration Token');
+        console.error('3. Set it as NOTION_TOKEN environment variable');
+        console.error('');
+        console.error('Example:');
         console.error('  NOTION_TOKEN="ntn_xxx..." npx notion-mcp-server');
         process.exit(1);
     }
@@ -18,7 +18,7 @@ async function main() {
         await startServer();
     }
     catch (error) {
-        console.error("Failed to start server:", error);
+        console.error('Failed to start server:', error);
         process.exit(1);
     }
 }

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

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

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

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