Notion集成服务

一个实现Claude AI与Notion工作空间无缝集成的MCP服务器,提供读写能力。

  • by edcolyer
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 edcolyer/mcp-server-notion

使用说明

MCP服务器概念

MCP(模型上下文协议)服务器实现,用于Claude AI和Notion工作区之间的无缝集成,实现读写功能。

项目概述

该项目旨在构建一个MCP服务器,将Claude AI连接到Notion工作区,使Claude能够:

  • 从Notion数据库和页面读取内容
  • 更新现有内容
  • 在您的Notion工作区中搜索
  • 查询和筛选数据库条目
  • 检索详细的页面内容和数据库模式

先决条件

  • Node.js(v16+)
  • 通知API密钥
  • 克劳德桌面

入门指南

1.设置Notion API访问

  1. 在以下位置创建Notion集成https://www.notion.so/my-integrations
  2. 命名您的集成(例如“Claude MCP集成”)
  3. 将集成类型设置为“内部”
  4. 复制API密钥
  5. 通过单击任何页面/数据库右上角的“…”菜单并选择“添加连接”,与集成共享您的Notion页面和数据库

2.安装依赖项

npm install

3.配置环境变量

创建一个 .env 使用您的Notion API密钥在项目根目录中创建文件:

NOTION_API_KEY=your_api_key_here

只有在开发服务器时才需要此步骤。

4.建造

构建服务器,准备供Claude使用。

npm run build

如果你正在开发服务器,你可以运行 npm run dev 或 npm run inspect.

5.添加到Claude桌面配置

打开 claude_desktop_config.json (导航到 Settings > Developer 然后单击 Edit Config)并添加以下内容:

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}

6.重启克劳德

重新启动克劳德,你应该可以走了!

可用特征

MCP服务器提供以下工具:

  • search_notion:使用查询字符串在Notion工作区中搜索
  • get_notion_page:从特定的Notion页面检索详细内容
  • get_notion_database:检索Notion数据库的元数据和架构
  • query_notion_database:在支持复杂查询的Notion数据库中搜索和过滤条目

资源和参考

贡献

欢迎投稿!请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。