Browse Your Entire Notion Workspace Not Just One Database

🚀 Notion ワークスペース全体を閲覧する

このプロジェクトは、Markdown ベースの Notion を利用して、ROOT_PAGE 変数を1つだけ使用することで、トークン不要でワークスペース全体を走査できます。

• Notion MCP サーバー：notion-texonom
• Notion ページをテキスト/Markdown 形式に変換：ページ内容を text/markdown タイプのノートとして保存します。
• 関連ページの検索と取得：グラフ距離に基づいて検索します（親、子、参照関係を考慮）。

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

✨ 主な機能

リソース

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

ツール

• ノートの検索：search_notes ツールを使用して、クエリ文字列で関連ページをフィルタリングできます。
  • 入力：フィルタリングに使用する関連テキストクエリ。
  • 出力：一致するノートの 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 インスペクターを使用します。インスペクターを起動するには、以下のコマンドを実行します。

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 を実際のフォルダパスに置き換えてください。