🚀 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. 运行测试以验证所有内容正常工作