Notion MCP Advanced

🚀 Notion MCP 集成

本項目是一個簡單的 Model Context Protocol (MCP) 服務器，它與 Notion 的 API 集成，可藉助 Claude 管理個人待辦事項列表。該實現專為極簡風格的 Notion 待辦事項列表量身打造。

🚀 快速開始

此項目基於 danhilse/notion_mcp，並遵循 MIT 許可證提供。

✨ 主要特性

• 添加新的待辦事項，帶有描述和鏈接
• 查看所有待辦事項
• 標記任務為完成
• 將外部資源鏈接到任務

⚠️ 重要說明

此項目是一個個人項目，專為一個非常具體的用例設計：我的簡單 Notion 待辦事項列表，它包含四個屬性：

• 任務（標題）
• 複選框（標記是否完成）
• 描述（額外細節）
• 鏈接（URL 或引用）

示例 Notion 數據庫

儘管你可以以此作為起點開始你的 Notion 集成，但你可能需要根據自己的數據庫結構和需求修改代碼。

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• Notion 賬戶
• Notion 的 API 密鑰
• 符合上述結構的 Notion 數據庫（或修改代碼以適應你的結構）

設置步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp

2. 設置 Python 環境：

python -m venv .venv
source .venv/bin/activate  # Windows 使用：.venv\Scripts\activate
pip install -e .

3. 創建 Notion 集成：

   • 訪問 https://www.notion.so/my-integrations
   • 創建新集成
   • 複製 API 密鑰

4. 與你的數據庫共享集成：

   • 打開你的待辦事項數據庫
   • 點擊“...”菜單 → “添加連接”
   • 選擇你的集成

5. 創建 .env 文件：

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

6. 配置 Claude Desktop：

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

💻 使用示例

運行服務器

服務器有兩種運行方式：

直接從命令行運行：

# 在項目目錄中，虛擬環境已激活時
python -m notion_mcp

自動通過 Claude Desktop（推薦）：

• 如果配置正確，服務器會在 Claude 啟動時啟動
• 請參考 Claude Documentation 瞭解詳細信息

使用說明

• 在 Notion 中創建一個包含待辦事項的數據庫，並確保它與你的 .env 配置匹配
• 啟動服務器，然後通過 Claude 調用 MCP 接口來管理你的待辦事項

📚 詳細文檔

注意事項

• 此項目目前僅支持基本的 CRUD 操作
• 請根據你的需求擴展功能
• 如有錯誤或問題，請檢查日誌或重新審視配置

項目結構

notion-mcp/
├── server.py       # 主服務器文件
├── config.py      # 配置和環境變量
└── README.md      # 項目文檔

感謝使用 Notion MCP 集成！如果有任何問題或建議，請隨時提出。