金大哥 - Notion_MCP_advanced MCP 详情

article

README

🚀 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 数据库（或修改代码以适应你的结构）

设置步骤

克隆仓库：

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 集成！如果有任何问题或建议，请随时提出。

Notion_MCP_advanced