Notion Server

🚀 Notion MCP サーバー

Notion とシームレスに統合することができるモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、言語モデルは標準化されたツールを通じて、ワークスペース内のページやデータベースを検索、読み取り、作成、更新することができます。

✨ 主な機能

ページ操作

• 🔍 Notion ワークスペース全体を検索
• 📝 豊富な Markdown 内容を持つ新しいページを作成
• 📖 整然とした形式でページ内容を読み取り
• 🔄 既存のページを更新
• 💬 コメントを追加および取得
• 🧱 ブロックレベルの操作（更新、削除）

拡張 Markdown サポート

• 多段階見出し（H1 - H3）
• 言語サポート付きのコードブロック
• チェックボックス状態付きのインタラクティブなタスク
• 複数行対応の引用
• 水平区切り線
• 説明付きの画像
• 入れ子になった箇条書き

データベース操作

• データベースの作成と管理
• データベース項目の追加と更新
• フィルターとソートを使用したクエリ
• 複数の属性タイプをサポート：
  • タイトル、リッチテキスト、数値
  • 単一選択、複数選択
  • 日付、チェックボックス
  • など！

🚀 クイックスタート

前提条件

• Node.js（v16 以上）
• Notion API キー
• MCP 互換クライアント（例：Claude Desktop）

インストール

1. リポジトリをクローンします：

git clone https://github.com/v-3/notion-server.git
cd notion-server

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

npm install

3. 環境を設定します：

# .env ファイルを作成
echo "NOTION_API_KEY=あなたの Notion API キー" > .env

# または直接エクスポート
export NOTION_API_KEY=あなたの Notion API キー

4. サーバーをビルドします：

npm run build

🔧 設定

Claude Desktop の設定

1. Claude Desktop の設定ファイル（claude_desktop_config.json）を更新します：

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/絶対パス/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "あなたの Notion API キー"
            }
        }
    }
}

2. Claude Desktop を再起動して変更を適用します。

💻 使用例

基本的な使用法

// ページを検索
{
    query: string // 検索クエリ
}

// ページを読み取り
{
    pageId: string // 読み取るページの ID
}

// ページを作成
{
    title?: string,      // ページのタイトル
    content?: string,    // ページの内容（Markdown 形式）
    parentPageId: string // 親ページの ID
    properties?: object  // データベース項目の属性
}

// ページを更新
{
    pageId: string,   // 更新するページの ID
    content: string   // 新しい内容（Markdown 形式）
}

高度な使用法

// データベース項目を作成
{
    title: string      // 項目のタイトル
    content?: string  // オプションの内容（Markdown 形式）
    properties: object // 属性、例：{ "タスク状態": "未完成" }
}

// データベース項目を更新
{
    pageId: string   // 更新するページの ID
    properties: object // 新しい属性値、例：{ "タスク状態": "完了" }
}

📚 ドキュメント

1. プロジェクトを初期化する：

   • リポジトリをクローンし、依存関係をインストールします：git clone https://github.com/v-3/notion-server.git && cd notion-server && npm install

2. 環境変数を設定する：

   • .env ファイルを作成し、NOTION_API_KEY=あなたの API キー を追加します。

3. サーバーを起動する：

   • プロジェクトのルートディレクトリで実行します：npm start

4. ツールを使用する：

   • /api/pages に POST リクエストを送信して、ページまたはデータベース項目を作成します。
   • /api/pages/{pageId} に PUT リクエストを送信して、既存のページまたはデータベース項目を更新します。

📄 ライセンス

• このプロジェクトは MIT ライセンスに準拠しており、詳細は LICENSE ファイルを参照してください。
• 使用する前に、Notion の API ドキュメントと関連する法的条項をよく読んでください。

⚠️ 重要提示

sweir1 のバージョンを使用する場合は、直接彼のリポジトリをクローンしてください：

git clone https://github.com/sweir1/notion-server.git