MCP Server

1つのデータベースだけでなく、Notionワークスペース全体を参照します

Markdown ベースの Notion は、単一のROOT_PAGE変数を使用して MCP をナビゲートし、トークンの必要性を排除します。

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

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

特徴

リソース

• ノートにアクセス: UUID スラッグを持つnote:// URI として Notion ページを一覧表示および取得します。
• メタデータ: 各リソースには、タイトル、説明、および Markdown 形式のコンテンツが含まれます。
• MIME タイプ: コンテンツはtext/markdown形式でアクセスできます。

ツール

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

プロンプト

• ノートの要約: Notion の個々のページの要約を生成します。
  • 利用可能なプロンプト:
    • summarize_note : URI で特定のメモを要約します。
    • suggest_refactor : 構造的な改善を提案します。
    • suggest_fix : メモの内容に対する潜在的な修正を特定します。
    • suggest_enhance : メモを改善するための強化策を提案します。
  • 入力: Notion ページ URI。
  • 出力: 要約と拡張のための構造化されたメッセージ。

発達

設定

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

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

自動リビルドを使用した開発の場合:

構成

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

構成例:

デバッグ

MCPサーバーのトラブルシューティングとデバッグには、MCPインスペクターを使用します。インスペクターを起動するには、次のコマンドを実行します。

Inspector は、stdio ベースのサーバー通信を検査するためのブラウザベースのインターフェースを提供します。

主要技術

• Notion 統合: @texonom/nclientと@texonom/cli.
• MCP SDK: サーバー操作用に@modelcontextprotocol/sdkを実装します。

リモート展開

サーバーはリモート通信にSSEServerTransportを使用するようになり、サーバーの共有利用が可能になりました。必要な依存関係がインストールされ、サーバーがリモート展開用に正しく構成されていることを確認してください。

使用方法

SSEServerTransportを使用してサーバーを実行するには、次のコマンドを使用します。

/some/folderフォルダーへの適切なパスに置き換えてください。