MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Converts Notion pages into text/markdown mimeType notes for access through the MCP server

  • Integrates with Notion to convert pages into markdown notes, allows searching and retrieving Notion pages, and provides tools for summarizing and enhancing Notion content

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。
    • 出力: 要約と拡張のための構造化されたメッセージ。

発達

設定

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

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

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

-
security - not tested
F
license - not found
-
quality - not tested

この TypeScript ベースの MCP サーバーを使用すると、ユーザーは Model Context Protocol (MCP) を使用してテキスト ノートを作成および要約することで、シンプルなノート システムを管理できます。

  1. Features
    1. Resources
    2. Tools
    3. Prompts
  2. Development
    1. Setup
  3. Configuration
    1. Installation for Claude Desktop
      1. Debugging
    2. Key Technologies
      1. Remote Deployment
        1. Usage Instructions
          ID: nfvsflhblv