Browse your entire Notion workspace, not just one database

Notion ワークスペース全体をブラウズ。1 つのデータベースに限定されません

単一の ROOT_PAGE 変数だけで Notion をナビゲートする Markdown ベースの MCP。トークンは不要です。

• Notion MCP サーバー：notion-texonom
• Notion ページは text/markdown mimeType のノートに変換されます。
• 親子関係や参照関係を考慮したグラフ距離に基づき、関連するページを検索して取得します。

Notion ベースのノートを管理し、操作するための Model Context Protocol（MCP）サーバーです。この TypeScript ベースのサーバーは、リソース、ツール、プロンプトを統合して Notion ページを効率的に操作し、MCP の概念を示します。

機能

リソース

• ノートへのアクセス：Notion ページを、UUID スラッグを持つ note:// URI として一覧表示、取得します。
• メタデータ：各リソースには、タイトル、説明、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 Inspector を使用します。Inspector を起動するには、次のコマンドを実行します：

pnpm inspector

Inspector では、stdio ベースのサーバー通信を確認できるブラウザベースのインターフェースを利用できます。

主なテクノロジー

• 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 を適切なフォルダーのパスに置き換えてください。