🚀 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"
}
}
}
}
请确保：
- 将
/path/to/notion-chakra-mcp替换为你的实际项目路径 - 设置你的
NOTION_API_KEY值 - 在项目根目录中创建一个
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
添加新功能
- 在
src/中添加你的功能实现 - 在
tests/中添加测试 - 如果需要，更新 requirements.txt
- 运行测试以验证所有内容正常工作