🚀 Notion MCP 集成
本项目是一个简单的 Model Context Protocol (MCP) 服务器，它与 Notion 的 API 集成，可借助 Claude 管理个人待办事项列表。该实现专为极简风格的 Notion 待办事项列表量身打造。
🚀 快速开始
此项目基于 danhilse/notion_mcp，并遵循 MIT 许可证提供。
✨ 主要特性
- 添加新的待办事项，带有描述和链接
- 查看所有待办事项
- 标记任务为完成
- 将外部资源链接到任务
⚠️ 重要说明
此项目是一个个人项目，专为一个非常具体的用例设计：我的简单 Notion 待办事项列表，它包含四个属性：
- 任务（标题）
- 复选框（标记是否完成）
- 描述（额外细节）
- 链接（URL 或引用）
尽管你可以以此作为起点开始你的 Notion 集成，但你可能需要根据自己的数据库结构和需求修改代码。
📦 安装指南
先决条件
- Python 3.10 或更高版本
- Notion 账户
- Notion 的 API 密钥
- 符合上述结构的 Notion 数据库（或修改代码以适应你的结构）
设置步骤
- 克隆仓库：
git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
- 设置 Python 环境：
python -m venv .venv
source .venv/bin/activate # Windows 使用：.venv\Scripts\activate
pip install -e .
-
创建 Notion 集成：
- 访问 https://www.notion.so/my-integrations
- 创建新集成
- 复制 API 密钥
-
与你的数据库共享集成：
- 打开你的待办事项数据库
- 点击“...”菜单 → “添加连接”
- 选择你的集成
-
创建
.env文件：
NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here
- 配置 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 集成！如果有任何问题或建议，请随时提出。