MCP Notion

🚀 Notion ワークスペース全体の閲覧（単一のデータベースだけでなく）

Markdown ベースの Notion は、単一の ROOT_PAGE 変数を使用してトークンなしでグローバルな閲覧を実現します。

• Notion MCP サーバー：notion-texonom
• Notion ページを text/markdown 形式のノートに変換
• グラフ距離に基づく関連ページの検索と取得：親、子、参照関係を考慮します。

これは、Notion のノートベースの Model Context Protocol (MCP) サーバーを管理および操作するためのものです。この TypeScript 実装は、MCP の概念を示し、リソース、ツール、プロンプトを統合して Notion ページと効率的にやり取りします。

🚀 クイックスタート

このサーバーを使用することで、Notion ワークスペース全体をトークンなしで閲覧できます。以下のセクションで詳細な設定方法や使用方法を説明します。

✨ 主な機能

リソース

• ノートへのアクセス：Notion ページを note:// URI として一覧表示し、UUID でマークして取得できます。
• メタデータ：各リソースには、タイトル、説明、Markdown 形式の本文が含まれています。
• MIME タイプ：本文は text/markdown 形式でアクセスできます。

ツール

• ノートの検索：search_notes ツールを使用して、クエリ文字列で Notion ページを検索できます。
  • 入力：関連ページをフィルタリングするためのクエリテキスト。
  • 出力：一致するノートの Markdown 内容。

プロンプト

• ノートの要約：特定の Notion ページの要約を生成します。
  • 利用可能なプロンプト：
    • summarize_note：URI で指定されたノートを要約します。
    • suggest_refactor：構造改善の提案を行います。
    • suggest_fix：潜在的な修正内容を特定します。
    • suggest_enhance：ノートの品質を向上させるための強化策を提案します。
  • 入力：Notion ページの URI。
  • 出力：要約と改善の構造化されたメッセージ。

📦 インストール

セットアップ

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

pnpm install

プロジェクトをビルドします：

pnpm build

開発モードで自動再構築を行います：

pnpm watch

設定

サーバーを Notion と連携するように設定するには：

• 環境変数を設定します：
  • ROOT_PAGE：あなたの Notion ワークスペースのルートページ ID。

Claude Desktop へのインストール

Claude Desktop でこのサーバーを使用するには、以下の設定を追加します：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

設定例：

{
  "mcpServers": {
    "notion-texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

デバッグ

MCP サーバーの問題をデバッグするには、MCP インスペクターを使用します。インスペクターを起動します：

pnpm inspector

インスペクターは、ブラウザベースのインターフェイスを提供し、サーバーの標準入出力通信を確認できます。

🔧 技術詳細

• Notion 統合：@texonom/nclient と @texonom/cli でサポートされています。
• MCP SDK：サーバー操作に @modelcontextprotocol/sdk を実装しています。

🚀 リモートデプロイ

現在のサーバーは SSEServerTransport を使用してリモート通信を実現しており、共有サーバーの使用をサポートしています。リモートデプロイを行うには、必要な依存関係をインストールし、サーバーを正しく設定してください。

💻 使用例

SSEServerTransport でサーバーを実行するには、以下のコマンドを実行します：

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

/some/folder を適切なパスに置き換えてください。