🚀 Notion MCP 服务器
Notion MCP（模型上下文协议）服务器旨在为用户提供便捷的Notion页面及数据库管理功能，通过一系列API接口，可轻松实现页面的搜索、创建、编辑等操作，极大提升了信息管理效率。
🚀 快速开始
要使用Notion MCP服务器，需完成安装与配置，以下是详细步骤：
仓库克隆
使用以下命令克隆项目仓库：
git clone https://github.com/yourusername/notion-mcp-server.git
环境依赖
确保安装了以下工具：
- Node.js（推荐版本14.0及以上）
- npm或yarn包管理器
安装依赖项
进入项目目录后，运行命令：
npm install
或者
yarn install
配置API密钥
在项目的config.json文件中添加你的Notion API密钥：
{
"notion": {
"apiKey": "your_notion_api_key_here"
}
}
✨ 主要特性
Notion MCP服务器提供了丰富的功能，满足多样化的Notion使用需求：
- 搜索页面：通过关键字查找相关内容
- 获取页面内容：查看指定页面的详细信息
- 创建新页面：新建空白或基于模板的页面
- 编辑页面：对现有页面进行修改
- 删除页面：移除不需要的内容
- 管理数据库：操作和查询自定义数据库
💻 使用示例
基础用法
创建新页面
POST /api/pages
Content-Type: application/json
{
"title": "新建页面标题",
"content": "页面内容描述..."
}
查询数据库
GET /api/databases/{databaseId}/query
Query-Param: {
"filter": {
"property": "状态",
"select": {
"equals": "完成"
}
},
"sort": {
"property": "创建时间",
"direction": "ascending"
}
}
🔧 故障排除
如果遇到问题，请检查以下内容：
- 确认API密钥配置正确且具有相应权限
- 查看服务器日志：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log - 确保所有请求格式符合Notion API规范
📚 未来改进计划
- 支持复杂查询功能
- 增加内容格式化选项
- 扩展更多数据块类型支持