MCP Notion

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

本項目基於 Markdown，藉助單一的 ROOT_PAGE 變量即可實現對 Notion 的全局瀏覽，且無需令牌。它是一個用於管理並與 Notion 基於筆記的 Model Context Protocol (MCP) 服務器，此 TypeScript 實現展示了 MCP 的概念，通過集成資源、工具和提示，能夠高效地與 Notion 頁面交互。

✨ 主要特性

• Notion MCP 服務端：notion-texonom。
• 格式轉換：可將 Notion 頁面轉換為 text/markdown 格式筆記。
• 關聯搜索：基於圖距離搜索和檢索相關頁面，同時考慮父級、子級和引用關係。

💻 使用示例

資源

• 訪問筆記：可列出並檢索 Notion 頁面作為 note:// URI，且附帶 UUID 標記。
• 元數據：每個資源包含標題、描述和 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

檢查器提供了一個基於瀏覽器的界面來檢查標準輸入輸出的服務器通信。

🔧 技術細節

• 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 替換為適當的路徑。