akirapapa-mcp-notion-server

🚀 Notion MCP 服务器

Notion MCP 服务器借助 Notion API 实现了 MCP（机器学习控制平面），它能让 Claude 与 Notion 工作区进行交互，为用户带来更便捷的操作体验。

✨ 主要特性

该服务器提供了一系列工具，可对 Notion 中的块、页面和数据库进行操作，具体如下：

1. notion_append_block_children：向父块追加子块。
   • 必填输入：
     • block_id (字符串)：父块的 ID。
     • children (数组)：要追加的块对象数组。
   • 返回：关于已添加块的信息。
2. notion_retrieve_block：获取特定块的详细信息。
   • 必填输入：
     • block_id (字符串)：要获取的块 ID。
   • 返回：关于该块的详细信息。
3. notion_retrieve_block_children：获取特定块的子块。
   • 必填输入：
     • block_id (字符串)：父块的 ID。
   • 可选输入：
     • start_cursor (字符串)：下一页结果的游标。
     • page_size (数字，默认值：100，最大值：100)：要获取的块数量。
   • 返回：子块列表。
4. notion_delete_block：删除特定块。
   • 必填输入：
     • block_id (字符串)：要删除的块 ID。
   • 返回：确认已删除的信息。
5. notion_retrieve_page：获取特定页面的详细信息。
   • 必填输入：
     • page_id (字符串)：要获取的页面 ID。
   • 返回：关于该页面的详细信息。
6. notion_update_page_properties：更新页面属性。
   • 必填输入：
     • page_id (字符串)：要更新的页面 ID。
     • properties (对象)：要更新的属性。
   • 返回：关于已更新页面的信息。
7. notion_create_database：创建新的数据库。
   • 必填输入：
     • parent (对象)：数据库的父对象。
     • title (数组)：数据库的标题（富文本数组）。
     • properties (对象)：数据库属性。
   • 返回：新创建的数据库。
8. notion_delete_database：删除特定数据库。
   • 必填输入：
     • database_id (字符串)：要删除的数据库 ID。
   • 返回：确认已删除的信息。
9. notion_retrieve_databases：获取所有数据库列表。
   • 返回：数据库列表。
10. notion_query_database：查询特定数据库的内容。
    • 必填输入：
      • database_id (字符串)：要查询的数据库 ID。
      • query (对象)：查询参数。
    • 返回：数据库查询结果。
11. notion_create_page：创建新页面。
    • 必填输入：
      • parent (对象)：页面的父对象。
      • properties (对象)：页面属性。
      • children (数组)：初始子块。
    • 返回：新创建的页面。

📦 安装指南

若要在 Notion 中配置 MCP 服务器，请按照以下步骤操作：

1. 创建 Notion 集成：在 Notion 中创建一个新的集成，确保启用所需的权限（如“读取和写入”）。
2. 获取集成令牌：创建完成后，复制集成的令牌（也称为 API 令牌），这将是后续配置的关键。
3. 将集成连接到工作区：
   • 打开 Notion 中的相关页面或数据库。
   • 点击右上角导航栏中的按钮。
   • 点击“连接到”按钮并选择您的集成。
4. 配置 Claude Desktop：在 claude_desktop_config.json 文件中添加以下内容：

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["your-built-file-path"],
            "env": {
                "NOTION_API_TOKEN": "your-integration-token"
            }
        }
    }
}

🚧 故障排除

如果遇到权限错误，请执行以下步骤：

1. 确保集成具有所需的权限。
2. 验证集成是否已受邀加入相关页面或数据库。
3. 确认令牌和配置在 claude_desktop_config.json 中正确设置。

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。