Notionmcp

🚀 Notion MCP 服务器

这是一个模型上下文协议（MCP）服务器，它能将Claude和其他AI助手连接到您的Notion工作区。借助此集成，AI助手可以查看、搜索并操作您的Notion数据库、页面及区块内容。

🚀 快速开始

该工具充当AI助手（如Claude）与您的Notion工作区之间的桥梁。它使AI能够：

• 查看并搜索您的Notion数据库
• 创建和更新页面
• 管理内容区块
• 以及其他更多功能！

📦 安装指南

先决条件

• Node.js（版本14或更高）
• Notion账户
• Claude桌面应用程序（如果您打算与Claude一起使用）

安装步骤

第一步：获取Notion API密钥

1. 登录Notion。
2. 进入“设置” > “安全” > “生成API密钥”。
3. 复制生成的API密钥。

第二步：安装Node.js

1. 下载并安装Node.js（包括npm）。
   • 访问Node.js官方页面下载适合您操作系统的版本。
2. 安装完成后，打开终端或命令提示符，输入以下命令验证：

   node -v
   npm -v
   

   如果显示版本号，则安装成功。

第三步：克隆Notion MCP服务器仓库

1. 打开终端或命令提示符。
2. 运行以下命令克隆仓库到您的本地机器：

   git clone https://github.com/notion-mcp-server/notion-mcp.git
   

3. 切换到克隆后的目录：

   cd notion-mcp
   

第四步：安装依赖项

1. 运行以下命令安装项目所需的依赖项：

   npm install
   

第五步：配置服务器

1. 在项目根目录中创建一个.env文件。
2. 添加以下内容到.env文件，替换占位符为您的实际值：

   NOTION_API_KEY=your_notion_api_key_here
   

3. 保存并关闭文件。

第六步：启动服务器

1. 在终端或命令提示符中运行以下命令启动服务器：

   npm start
   

2. 如果一切正常，您将在控制台看到类似以下的输出：

   Server is running on port 3000
   

✨ 主要特性

该服务器为AI助手提供以下工具：

• list-databases：列出所有可访问的数据库
• query-database：从数据库获取条目
• create-page：在数据库中添加新页面
• update-page：修改现有页面
• create-database：创建新的数据库
• update-database：修改数据库结构
• get-page：查看特定页面
• get-block-children：获取页面内容区块
• append-block-children：在页面中添加内容
• update-block：编辑内容区块
• get-block：查看特定块
• search：在整个工作区中搜索内容

🔧 技术细节

故障排除

常见问题：

1. “连接失败”在Claude中出现：
   • 检查claude_desktop_config.json文件中的服务器路径是否正确。
   • 确保您的Notion API密钥有效。
   • 确认Node.js已安装。
2. “访问被拒绝”当访问Notion内容时：
   • 确保您已共享页面/数据库与您的集成
   • 检查API密钥是否具有必要的权限。
3. 服务器无法启动：
   • 确保所有依赖项已安装（npm install）。
   • 检查.env文件是否存在且包含有效的API密钥。

获取帮助

如果您遇到未在此处列出的问题，请：

• 查看控制台输出中的错误消息
• 确保您的Notion API密钥有效
• 验证您的集成是否具有访问页面/数据库的权限

📄 许可证

MIT