Notion MCP Server 1y7

🚀 Notion MCP サーバー

Notion API 用に実装されたモデルコンテキストプロトコル (MCP) サーバーです。このサーバーにより、AI アシスタントが Notion ワークスペースとプログラム的にやり取りできるようになります。LLM に対して、Notion のデータベース、ページ、ブロックなどのコンテンツにアクセスし操作するための標準化されたインターフェースを提供します。

🚀 クイックスタート

この Notion MCP サーバーは、AI アシスタントと Notion ワークスペースを接続する役割を果たし、AI ツールが Notion のコンテンツを操作できるようにします。

✨ 主な機能

データベース操作

• フィルターとソートを使用してデータベースをクエリする
• カスタム属性を持つ新しいデータベースを作成する
• 既存のデータベーススキーマと属性を更新する
• データベースを検索する

ページ操作

• 属性とコンテンツを使用してページを作成する
• ページのコンテンツとメタデータを取得する
• ページの属性を更新する
• （近日公開）ブロックとそのコンテンツを管理する

📦 インストール

前提条件

1. Node.js と npm（バージョン 14 以上）
2. Docker（オプションの Docker サポート用）

Notion 統合の作成

1. Notion 開発者パネルにアクセスする
2. 新しい統合を作成し、API キーを取得する

コンテンツの共有

• 新しく作成した統合を Notion ワークスペースまたは特定のページ/データベースに招待する

インストール手順

1. このリポジトリをクローンする：

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

2. 依存関係をインストールする：

   npm install
   

設定

1. .env.example を .env ファイルにコピーする：

   cp .env.example .env
   

2. .env ファイルで以下の変数を設定する：
   • NOTION_API_KEY: あなたの Notion API キー
   • NOTION_WORKSPACE_ID: あなたのワークスペース ID

サーバーの起動

npm run dev

Claude Desktop の設定

1. config.ts ファイルで以下の内容を設定する：

   export const config = {
     tools: {
       notion: {
         apiKey: process.env.NOTION_API_KEY,
         workspaceId: process.env.NOTION_WORKSPACE_ID,
       },
     },
   };
   

📚 ドキュメント

ツール

データベースツール

• queryDatabase: Notion データベースをクエリする
• createDatabase: 新しいデータベースを作成する
• updateDatabase: 既存のデータベース属性を更新する

ページツール

• createPage: 属性とコンテンツを使用してページを作成する
• retrievePage: 特定のページのコンテンツとメタデータを取得する
• updatePage: ページの属性とコンテンツを更新する

プロジェクト構造

notion-mcp/
├── src/
│   ├── services/
│   │   └── notion.ts             # Notion クライアントサービス  
│   ├── config.ts                 # アプリケーション設定
│   ├── env.ts                    # t3-env モード 
│   ├── index.ts                  # サーバーエントリポイント
│   ├── utils/
│   │   └── error-handling.ts     # エラーハンドリングツール
│   └── tools/
│       ├── index.ts              # すべてのツールをエクスポートする
│       ├── 数据库/            # データベース関連ツール
│       │   ├── handler.ts        # データベース操作ハンドラー
│       │   ├── index.ts          # データベースツールをエクスポートする
│       │   └── schema.ts         # Zod スキーマ（データベース操作）
│       └── pages/                # ページ関連ツール
│           ├── handler.ts        # ページ操作ハンドラー
│           ├── index.ts          # ページツールをエクスポートする
│           └── schema.ts         # Zod スキーマ（ページ操作）
├── tsconfig.json
├── package.json  
├── todos.md
├── README.md
└── bun.lock

何は MCP ですか？

モデルコンテキストプロトコル (MCP) は、大規模言語モデル (LLM) を外部のツール、データソース、API に接続する標準プロトコルです。これにより、AI アシスタントが安全かつ標準化された方法で機能とデータにアクセスできます。この Notion MCP サーバーは、このプロトコルを実装しており、AI アシスタントがあなたの Notion ワークスペースにアクセスできるようにします。

プロジェクトの目的

このプロジェクトは、AI アシスタントと Notion ワークスペースを接続する橋渡しの役割を果たし、AI ツールが以下の操作を実行できるようにします。

• データベースをクエリして検索する
• ページを取得および作成する
• ページの属性とコンテンツを更新する
• データベースを作成および更新する
• （近日公開）ブロックとそのコンテンツを管理する

Notion 用に MCP プロトコルを実装することで、このサーバーは AI アシスタントがユーザーの Notion ワークスペースをより効率的に管理できるように支援します。

📄 ライセンス

MIT