Notion MCP Server 7hr

🚀 NOTION-MCP-SERVER

這是一個用於與Notion集成的MCP（多方協作協議）服務器項目。我們旨在通過提供簡單易用且功能強大的API，助力開發者快速構建與Notion協同工作的應用程序。

🚀 快速開始

在五分鐘內設置本地MCP服務器：

git clone https://github.com/your-username/notion-mcp-server.git
cd notion-mcp-server
npm install
npm start

✨ 主要特性

• 支持Notion API：藉助MCP協議與Notion平臺實現全面集成。
• 易於部署和擴展：採用現代架構，保障服務器穩定運行且便於擴展。
• 詳細的文檔支持：提供全面的API文檔和技術指南，助力開發者快速上手。

📦 安裝指南

為了使項目正常工作，請在項目設置中啟用以下權限：

{
  "notion": {
    "read_write": true,
    "discussion_comments": true,
    "database_access": true,
    "user_management": true
  }
}

💻 使用示例

基礎用法

const { NotionMCPClient } = require('notion-mcp-client');

async function quickStart() {
    const client = new NotionMCPClient({
        token: 'your_notion_integration_token'
    });

    // 創建新頁面
    const pageId = await client.pages.create({
        title: 'My New Page',
        content: 'This is a test page created via MCP.'
    });

    console.log('頁面ID:', pageId);
}

quickStart().catch(console.error);

📚 詳細文檔

完整API文檔

以下是完整的Notion MCP Server API接口列表：

1. 創建頁面

• 方法：POST /api/pages/create
• 參數：
  • title: string
  • content: string
• 返回值：新創建的頁面ID

2. 更新頁面內容

• 方法：PUT /api/pages/{pageId}
• 參數：
  • newContent: string
• 返回值：更新成功的狀態

3. 刪除頁面

• 方法：DELETE /api/pages/{pageId}
• 參數：無
• 返回值：刪除操作的狀態

4. 查詢數據庫

• 方法：GET /api/databases/{dbId}/query
• 參數：
  • filter: object (可選)
  • sorts: array (可選)
• 返回值：查詢結果數組

5. 創建新數據庫

• 方法：POST /api/databases
• 參數：
  • name: string
  • schema: object
• 返回值：新創建的數據庫ID

6. 獲取用戶信息

• 方法：GET /api/users/{userId}
• 參數：無
• 返回值：用戶詳細信息對象

7. 創建新用戶

• 方法：POST /api/users
• 參數：
  • username: string
  • email: string
  • role: string ("user" or "admin")
• 返回值：新建用戶的ID

8. 更新用戶角色

• 方法：PUT /api/users/{userId}/role
• 參數：
  • newRole: string
• 返回值：更新操作的狀態

9. 獲取當前用戶

• 方法：GET /api/users/current
• 參數：無
• 返回值：當前用戶的ID和角色信息

10. 處理文件上傳

• 方法：POST /api/files/upload
• 參數：
  • file: File對象
  • description: string (可選)
• 返回值：上傳的文件URL

如需進一步瞭解每個API的具體使用細節，請參考我們提供的完整開發者文檔。

🤝 貢獻指南

我們歡迎社區貢獻！如果你發現任何問題，請在GitHub上報告。我們也非常感謝你的功能建議和代碼提交。

📄 許可證

此MCP服務器基於MIT License授權，允許您自由使用、修改和分發軟件，前提是您保留版權聲明和許可信息。有關詳細信息，請參閱項目倉庫中的LICENSE文件。