Notion Server

🚀 Notion MCP 服務器

Notion MCP 服務器實現了與 Notion 的無縫集成，藉助模型上下文協議（MCP），讓語言模型能利用標準化工具，在工作區中開展頁面和數據庫的搜索、讀取、創建及更新操作。

🚀 快速開始

先決條件

• Node.js（v16 或更高版本）
• Notion API 密鑰
• MCP 兼容客戶端（例如 Claude Desktop）

安裝

1. 克隆倉庫：

git clone https://github.com/v-3/notion-server.git
cd notion-server

2. 安裝依賴項：

npm install

3. 設置環境：

# 創建 .env 文件
echo "NOTION_API_KEY=你的 Notion API 密鑰" > .env

# 或直接導出
export NOTION_API_KEY=你的 Notion API 密鑰

4. 構建服務器：

npm run build

配置

Claude Desktop 設置

1. 更新你的 Claude Desktop 配置文件（claude_desktop_config.json）：

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/絕對路徑/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "你的 Notion API 密鑰"
            }
        }
    }
}

2. 重啟 Claude Desktop 以應用更改。

使用說明

1. 初始化項目：
   • 克隆倉庫並安裝依賴：git clone https://github.com/v-3/notion-server.git && cd notion-server && npm install
2. 配置環境變量：
   • 創建 .env 文件並添加 NOTION_API_KEY=你的 API 密鑰
3. 啟動服務器：
   • 在項目根目錄下運行：npm start
4. 使用工具：
   • 發送 POST 請求到 /api/pages 創建頁面或數據庫項
   • 發送 PUT 請求到 /api/pages/{pageId} 更新現有頁面或數據庫項

✨ 主要特性

頁面操作

• 🔍 在整個 Notion 工作區中進行搜索
• 📝 創建帶有豐富 Markdown 內容的新頁面
• 📖 以整潔的格式讀取頁面內容
• 🔄 更新現有頁面
• 💬 添加和檢索評論
• 🧱 塊級操作（更新、刪除）

增強的 Markdown 支持

• 多級標題（H1 - H3）
• 帶語言支持的代碼塊
• 帶複選框狀態的交互式待辦事項
• 多行支持的引用
• 水平分隔線
• 帶說明的圖片
• 嵌套項目符號

數據庫操作

• 創建和管理數據庫
• 添加和更新數據庫項
• 使用過濾器和排序進行查詢
• 支持多種屬性類型：
  • 標題、富文本、數字
  • 單選、多選
  • 日期、複選框
  • 等等！

🛠️ 可用工具

頁面操作

// 搜索頁面
{
    query: string // 搜索查詢
}

// 讀取頁面
{
    pageId: string // 要讀取的頁面 ID
}

// 創建頁面
{
    title?: string,      // 頁面標題
    content?: string,    // 頁面內容（Markdown 格式）
    parentPageId: string // 父頁面 ID
    properties?: object  // 數據庫項屬性
}

// 更新頁面
{
    pageId: string,   // 要更新的頁面 ID
    content: string   // 新的內容（Markdown 格式）
}

數據庫操作

// 創建數據庫項
{
    title: string      // 事項標題
    content?: string  // 可選內容（Markdown 格式）
    properties: object // 屬性，例如 { "任務狀態": "未完成" }
}

// 更新數據庫項
{
    pageId: string   // 要更新的頁面 ID
    properties: object // 新屬性值，例如 { "任務狀態": "已完成" }
}

📖 詳細文檔

1. 初始化項目：
   • 克隆倉庫並安裝依賴：git clone https://github.com/v-3/notion-server.git && cd notion-server && npm install
2. 配置環境變量：
   • 創建 .env 文件並添加 NOTION_API_KEY=你的 API 密鑰
3. 啟動服務器：
   • 在項目根目錄下運行：npm start
4. 使用工具：
   • 發送 POST 請求到 /api/pages 創建頁面或數據庫項
   • 發送 PUT 請求到 /api/pages/{pageId} 更新現有頁面或數據庫項

📄 許可證

• 項目遵循 MIT 許可證，詳細內容請參閱 LICENSE 文件。
• 使用前請仔細閱讀 Notion 的 API 文檔和相關法律條款。

⚠️ 重要提示

如需使用 sweir1 的版本，請直接克隆其倉庫：

git clone https://github.com/sweir1/notion-server.git