MCP Notion Server

🚀 mcp-notion-server

一個用於 Notion 集成的 Model Context Protocol 服務器，此服務器基於 TypeScript 實現，搭建起了 Claude 和 Notion 之間的橋樑，實現了與 Notion 的數據庫和頁面進行無縫交互。其通過 Notion 資源管理、內容的 CRUD 操作工具以及基於 AI 的提示內容分析等核心 MCP 概念得以展現價值。

🚀 快速開始

這個基於 TypeScript 的 MCP 服務器實現了 Claude 和 Notion 之間的橋樑，允許與 Notion 的數據庫和頁面進行無縫交互。它通過以下核心 MCP 概念進行了演示：

• Notion 頁面和數據庫的資源管理
• 內容的增刪改查（CRUD）操作工具
• 基於 AI 的提示內容分析

✨ 主要特性

資源

• 通過 URI 訪問 Notion 頁面和數據庫
• 支持純文本和富文本內容類型
• 提取 Notion 屬性的元數據

工具

數據庫操作

• list_databases - 列出所有可訪問的 Notion 數據庫
• create_database - 創建具有自定義屬性的新數據庫
• query_database - 搜索和過濾數據庫條目
• update_database - 修改數據庫屬性和架構

頁面操作

• create_page - 在數據庫或子頁面中創建新頁面
  • 支持標題、屬性和 Markdown 內容
• update_page - 更新現有頁面屬性
• get_page - 獲取頁面內容和元數據
• delete_page - 從數據庫或父頁面刪除頁面

塊操作

• append_blocks - 向頁面添加新塊
• delete_blocks - 從頁面中刪除塊
• get_blocks - 檢索塊內容
• update_blocks - 修改現有塊內容

提示語

• summarize_notes - 生成筆記的簡潔摘要
• analyze_content - 提供頁面內容的見解和分析
• suggest_tags - 根據內容推薦相關標籤

📦 安裝指南

先決條件

• Node.js 18 或更高版本
• Notion API Key 和集成設置
• Claude Desktop 應用程序安裝

與 Claude Desktop 集成

創建一個 Notion 集成：

1. 訪問 Notion 的您的集成頁面。
2. 點擊“新建集成”。
3. 命名您的集成並選擇適當的權限（例如，“讀取內容”，“更新內容”）。
4. 獲取 Secret Key：
5. 複製集成的“內部 Integration Token”。這個令牌將用於身份驗證。
6. 將集成添加到您的工作區：
7. 在 Notion 中打開您想讓集成訪問的頁面或數據庫。
8. 點擊右上角的導航按鈕。
9. 點擊“Connect to”按鈕並選擇您的集成。

配置設置

將服務器配置添加到 Claude Desktop： MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

配置內容：

{
  "mcpServers": {
   "mcp-notion-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gabornyerges/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_KEY": "your-notion-api-key"
      }
    }
  }
}

調試

由於 MCP 服務器通過 stdio 通信，調試可能具有挑戰性。我們建議使用 MCP Inspector，該工具作為包腳本可用：

1. MCP Inspector

npm run inspector

📄 許可證

MIT 許可證 - 詳情請參閱 LICENSE