JinDaGe - SAhmadUmass_notion-mcp-server MCP Details

article

README

🚀 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规范

📚 未来改进计划

支持复杂查询功能
增加内容格式化选项
扩展更多数据块类型支持

SAhmadUmass_notion-mcp-server