Notion Chakra MCP

🚀 Notion Chakra MCP

這是一個集成到Notion的服務，提供MCP（消息控制協議）端點，用於與Notion數據庫和頁面交互。

🚀 快速開始

Notion Chakra MCP 是一個集成至 Notion 的服務，藉助 MCP 端點實現與 Notion 數據庫和頁面的交互。

✨ 主要特性

• 列出和查詢 Notion 數據庫
• 創建和更新頁面
• 搜索 Notion 內容
• 管理塊和子項
• 支持 stdio 和 SSE 傳輸

📦 安裝指南

1. MCP 客戶端配置（推薦）

將以下內容添加到你的~/.cursor/mcp.json：

{
  "mcpServers": {
    "notion-chakra-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/notion-chakra-mcp/data:/app/data",
        "-e",
        "TRANSPORT",
        "-e",
        "NOTION_API_KEY",
        "-e",
        "HOST",
        "-e",
        "PORT",
        "-e",
        "PYTHONPATH=/app/src",
        "notion-chakra-mcp"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "NOTION_API_KEY": "your_notion_api_key",
        "HOST": "0.0.0.0",
        "PORT": "8050"
      }
    }
  }
}

請確保：

1. 將/path/to/notion-chakra-mcp替換為你的實際項目路徑
2. 設置你的NOTION_API_KEY值
3. 在項目根目錄中創建一個data目錄：mkdir -p data

2. Docker Compose 設置

用於開發或獨立使用：

# 使用 stdio 傳輸構建並啟動
TRANSPORT=stdio docker-compose up notion-chakra-mcp

# 或使用 SSE 傳輸
TRANSPORT=sse docker-compose up notion-chakra-mcp

3. 直接 Docker 使用

用於手動測試或自定義設置：

# 構建鏡像
docker build -t notion-chakra-mcp .

# 使用 stdio 傳輸運行
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=stdio \
  -e NOTION_API_KEY=your_key \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp

# 使用 SSE 傳輸運行
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=sse \
  -e NOTION_API_KEY=your_key \
  -e HOST=0.0.0.0 \
  -e PORT=8050 \
  -p 8050:8050 \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp

📚 詳細文檔

配置

環境變量

• NOTION_API_KEY：你的 Notion 集成令牌（必需）
• TRANSPORT：傳輸類型（stdio或sse，默認為stdio）
• HOST：SSE 傳輸的服務器主機（默認為0.0.0.0）
• PORT：SSE 傳輸的服務器端口（默認為8050）
• PYTHONPATH：Python 模塊路徑（應為/app/src）

數據持久化

該服務使用data目錄進行持久存儲：

• 在容器內掛載到/app/data
• 存儲模式、數據庫映射和其他持久數據
• 必須在運行容器之前創建：mkdir -p data

開發

運行測試

# 安裝測試依賴項
pip install -r requirements.txt

# 運行測試
python -m pytest tests/ -v

添加新功能

1. 在src/中添加你的功能實現
2. 在tests/中添加測試
3. 如果需要，更新 requirements.txt
4. 運行測試以驗證所有內容正常工作