Notion Api MCP

🚀 Notion API MCP

Notion API MCP是一個基於模型上下文協議（MCP）的Python服務器，藉助Notion的API實現高級待辦事項管理與內容組織功能。MCP讓AI模型能與外部工具和服務無縫集成，充分發揮Notion的強大能力。

🚀 快速開始

克隆代碼並設置環境

git clone https://github.com/yourusername/notion-api-mcp.git
cd notion-api-mcp
uv venv && source .venv/bin/activate  # Windows用戶請使用 poetry install 或 conda create

安裝依賴項

pip install -r requirements.txt

運行服務器

python -m notion_api_mcp

✨ 主要特性

該Python服務器支持AI模型通過Notion API進行交互，具備以下功能：

• 待辦事項管理：可創建、更新和跟蹤任務，支持豐富的文本格式、截止日期、優先級及嵌套子任務。
• 數據庫操作：能創建和管理自定義屬性、過濾器及視圖的Notion數據庫。
• 內容組織：通過Markdown支持、層次列表及塊操作來結構化和整理內容。
• 即時集成：藉助乾淨的異步實現，可直接與Notion的工作區、頁面及數據庫交互。

完整功能列表 →

📚 詳細文檔

• 配置詳情：包含詳細的配置選項和環境變量說明。
• 功能列表：提供完整的功能列表及其實現細節。
• 架構概述：介紹工具使用情況及示例。
• API參考文檔：有詳細端點信息及實現細節。
• 測試覆蓋矩陣：展示測試覆蓋率及驗證狀態。
• 依賴管理：說明項目依賴項及版本信息。
• 變更日誌：記錄開發進展及更新情況。

💻 使用示例

入門指南

創建配置文件

在項目根目錄下創建一個config.yaml文件，內容如下：

database:
  name: "My Notion Database"  # 數據庫名稱
  id: "YOUR_NOTION_DATABASE_ID"  # 替換為你的Notion數據庫ID
  space_id: "YOUR_NOTION_SPACE_ID"  # 替換為空間ID

auth:
  token: "YOUR_NOTION_TOKEN"  # 替換為你的Notion API令牌

啟動服務器

# 在終端中運行以下命令啟動服務器
PYTHONPATH=/path/to/project python -m notion_api_mcp

🔧 技術細節

項目結構

notion_api_mcp/
├── config.py           # 配置文件
├── database.py         # 數據庫操作類
├── models.py           # Pydantic模型定義
├── server.py           # 主服務文件
└── utils/             # 工具函數

調試技巧

• 日誌輸出：
  • 開發模式：控制檯輸出。
  • 生產模式：文件日誌記錄。
  • 詳細錯誤信息及請求響應日誌（調試級別）。
• 設置環境變量：

export PYTHONPATH=/path/to/project

🚀 未來開發

計劃中的改進

1. 性能優化：
   • 實現請求緩存機制。
   • 優化數據庫查詢效率。
   • 引入連接池技術。
2. 高級功能：
   • 支持多工作區模式。
   • 批量操作功能。
   • 即時更新通知。
   • 高級搜索能力。
3. 開發者體驗提升：
   • 提供交互式API文檔。
   • 增加CLI工具。
   • 添加更多代碼示例。
   • 引入性能監控。
4. 測試增強：
   • 性能基準測試。
   • 負載測試。
   • 新增邊界情況測試。
   • 擴展集成測試。