Browse Your Entire Notion Workspace Not Just One Database

🚀 瀏覽您的整個 Notion 工作區，而不僅僅是單個數據庫

本項目基於 Markdown 實現了對 Notion 的操作，僅需使用一個 ROOT_PAGE 變量，無需令牌，就能遍歷整個 Notion 工作區。它提供了多種功能，如將 Notion 頁面轉換為文本或 Markdown 格式、搜索和檢索相關頁面等，能高效地與 Notion 頁面進行交互。

🚀 快速開始

本項目是一個用於管理並與 Notion 基於筆記的 Model Context Protocol (MCP) 服務器。該 TypeScript 實現展示了 MCP 概念，通過整合資源、工具和提示來高效地與 Notion 頁面交互。

✨ 主要特性

資源

• 訪問筆記：可列出並檢索 Notion 頁面，以 note:// URI（帶 UUID slug）的形式呈現。
• 元數據：每個資源包含標題、描述以及 Markdown 格式的正文內容。
• MIME 類型：正文內容能以 text/markdown 格式獲取。

工具

• 搜索筆記：藉助 search_notes 工具，可通過查詢字符串過濾相關頁面。
  • 輸入：用於篩選的相關文本查詢。
  • 輸出：匹配筆記的 Markdown 內容。

提示

• 總結筆記：能為單個 Notion 頁面生成摘要。
  • 可用提示：
    • summarize_note：通過 URI 摘要特定的筆記。
    • suggest_refactor：提出結構改進建議。
    • suggest_fix：識別潛在修復建議。
    • suggest_enhance：推薦改進以增強筆記內容。
  • 輸入：Notion 頁面 URI。
  • 輸出：摘要和增強的結構化消息。

📦 安裝指南

開發環境設置

1. 安裝依賴：

pnpm install

2. 構建項目：

pnpm build

3. 開發環境自動重建：

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 替換為您實際的文件夾路徑。