🚀 Notion MCP 服务器
Notion MCP 服务器基于 Notion API 构建，它能够让 Claude 与 Notion 工作区进行互动协作，为您的工作流程提供强大助力。
✨ 主要特性
- 提供多种工具集，方便对 Notion 的块、页面、数据库等进行操作。
- 支持与 Claude Desktop 集成，通过配置文件即可轻松使用。
📦 安装指南
文档中未提及具体安装步骤，可补充相关内容以方便用户使用。
💻 使用示例
基础用法
以下是使用notion_append_block_children工具向父块添加子块的示例：
# 假设这里有调用 notion_append_block_children 的代码
# 由于未提供实际代码，此处仅作示例示意
# 调用 notion_append_block_children 函数，传入父块 ID 和子块对象数组
result = notion_append_block_children(block_id="your_block_id", children=[{"type": "paragraph", "paragraph": {"text": [{"type": "text", "text": {"content": "This is a new child block."}}]}}])
print(result)
高级用法
在搜索内容时，使用可选参数进行分页搜索：
# 假设这里有调用 notion_search 的代码
# 由于未提供实际代码，此处仅作示例示意
# 调用 notion_search 函数，传入搜索关键词、每页结果数量和游标
result = notion_search(query="your_search_query", page_size=20, cursor="your_cursor")
print(result)
📚 详细文档
工具集
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(对象)：数据库属性。
- 返回信息：创建成功的数据库 ID。
8. notion_retrieve_databases
- 功能：获取所有数据库。
- 无必填输入。
- 返回信息：数据库列表。
9. notion_update_database_properties
- 功能：更新数据库属性。
- 必填输入：
database_id(字符串)：要更新的数据库 ID。properties(对象)：待更新的属性。
- 返回信息：已更新数据库的信息。
10. notion_delete_database
- 功能：删除数据库。
- 必填输入：
database_id(字符串)：要删除的数据库 ID。
- 返回信息：删除确认。
11. notion_search
- 功能：搜索内容。
- 必填输入：
query(字符串)：搜索关键词。
- 可选输入：
page_size(数字)：每页结果数量。cursor(字符串)：游标用于分页。
- 返回信息：搜索结果。
配置指南
若要通过Claude Desktop使用，请在claude_desktop_config.json中添加以下内容：
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["your-built-file-path"],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}
故障排除
若遇权限错误：
- 确保集成具备所需权限。
- 验证集成是否已添加到相关页面或数据库。
- 核实令牌及配置在
claude_desktop_config.json中设置正确。
📄 许可证
该 MCP 服务器基于 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。如需更多详情，请参阅项目仓库中的 LICENSE 文件。