Notion ReadOnly

🚀 読み取り専用のNotion MCPサーバー

このプロジェクトは、性能と効率を最適化した読み取り専用のNotion API MCPサーバーを実装しています。主にAIアシスタントがNotionの内容を照会および検索するために使用されます。

✨ 主な機能

• 読み取り専用設計: データ検索操作に特化し、Notionの内容に対する安全なアクセスを保証します。
• 最小限のツールセット: 公開するNotion APIツールの数を15以上から、ドキュメント分析に必要な6つの基本機能のみに削減しました。
• 並列処理: 非同期および並列APIリクエストを実装することで性能を向上させ、特にブロック内容の検索時の応答時間を大幅に短縮します。
• 拡張データベースアクセス: データベース、ページ属性、コメントの検索操作のサポートを追加しました。
• AIアシスタントの最適化: ツールの数を大幅に削減することで、CursorなどのAIアシスタントにおける「ツールが多すぎると性能が低下する」という問題を解決します。これらのモデルは通常、約40個のツールに制限されています。

ツールの比較

標準のNotion API統合と比較すると、この読み取り専用実装では公開するツールの数が大幅に少なく、AIアシスタントの性能が向上します。

削減されたツールセットは、推奨されるツール制限内に収まるのに役立ち、最適なAIアシスタントの性能を実現しながら、すべての基本機能を提供します。

📦 インストール

1. Notionでの統合設定:

https://www.notion.so/profile/integrationsにアクセスし、新しい内部統合を作成するか、既存のものを選択します。

Notion APIの範囲を読み取り専用操作に制限していますが、LLMにワークスペースデータを公開することには非ゼロのリスクがあります。セキュリティを重視するユーザーは、統合の_機能_をさらに設定することを検討する必要があります。

例えば、「設定」タブで「内容の読み取り」アクセス権のみを付与することができます。

2. 依存関係のインストール

以下のコマンドを使用して必要な依存関係をインストールします。

pnpm install

📚 ドキュメント

必要に応じて、config.tsファイルにある以下の設定パラメータを調整します。

// ネットワークリクエストのタイムアウト時間（秒）
export const TIMEOUT = 30;

// デバッグログを有効にするかどうか
export const DEBUG = false;

// デフォルトのページサイズ
export const DEFAULT_PAGE_SIZE = 100;

💻 使用例

基本的な使用法

pnpm build

高度な使用法

pnpm dev

📄 ライセンス

MIT

AIアシスタントの性能に与える恩恵

CursorやClaudeなどの最新のAIアシスタントは、ツールの数に一定の制限があります。

• ほとんどのモデルは、40個を超えるツールの合計を尊重しない可能性があります。
• ツールが多すぎると、全体的な性能と推論能力が低下します。
• 複雑なツールセットは、応答遅延を増加させ、決定の難易度を高めます。

この読み取り専用実装は、Notion APIの表面を簡素化することでこれらの問題を解決し、すべての基本機能を保持しながら、以下のような結果をもたらします。

• AIアシスタントのより高速かつ信頼性の高い応答
• Notionの内容とのやり取り時の精度向上
• API設計に特化することで、全体的な性能が向上します。