Notion MCP Server

🚀 Notion MCP サーバー

Notion MCP サーバーは、モデルコンテキストプロトコル（MCP）に基づくツールで、Notion プラットフォームとのインタラクションを可能にします。ページ、ブロック、データベース、コメントの操作をサポートしています。

🚀 クイックスタート

📦 インストール

リポジトリのクローン

git clone https://github.com/awkoy/notion-mcp-server.git
cd notion-mcp-server

依存関係のインストール

npm install

環境変数の設定

.env ファイルを作成します。

NOTION_TOKEN=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

プロジェクトのビルド

npm run build

チェックツールの実行

npm run inspector

💻 使用例

基本的な使用法

1. リポジトリをクローンします。
2. 依存関係をインストールします。
3. 環境変数を設定します。
4. サーバーまたはチェックツールを起動します。

📚 ドキュメント

開発ガイド

コード構造

• index.ts：メインエントリーファイル。
• tools/：Notion API とのやり取りに使用するツールモジュールが含まれています。
• schemas/：入出力検証に使用する Zod スキーマファイル。
• types/：カスタム型とインターフェースを定義します。

開発手順

1. リポジトリをクローンし、依存関係をインストールします。
2. 必要に応じてコードを変更または新機能を追加します。
3. チェックツールを使用してデバッグとテストを行います。
4. プロジェクトをビルドして本番用バージョンを生成します。

🔧 技術詳細

• ビルド技術：TypeScript と MCP SDK（バージョン 1.7.0+）を使用しています。
• 依存ライブラリ：Notion 公式クライアントライブラリ (@notionhq/client，バージョン 2.3.0+）を統合しています。
• プロトコル準拠：モデルコンテキストプロトコルの仕様に準拠しています。

トラブルシューティング

一般的な問題

• 認証エラー：Notion トークンが正しい権限を持ち、関連するページ/データベースのアクセスが有効になっていることを確認してください。
• ページアクセス問題：アクセスするページにインテグレーションが追加されていることを確認してください。
• レート制限：リクエストを最適化し、バッチ操作を使用して効率を向上させてください。

コントリビューションガイド

コントリビューションを歓迎します！以下の手順で Pull Request を送信してください。

1. リポジトリを Fork します。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m '添加很棒的功能')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を送信します。

📄 ライセンス

本プロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。