金大哥 - mcp-server-notion MCP 详情

article

README

🚀 Notion MCP 服务器

本项目是一个用于实现 Claude AI 和 Notion 工作区之间无缝集成的 Model Context Protocol (MCP) 服务器，支持读写功能，能让 Claude AI 与 Notion 高效协作。

🚀 快速开始

1. 设置 Notion API 访问权限

前往 https://www.notion.so/my-integrations 创建一个 Notion 集成。
为你的集成命名（例如：“Claude MCP Integration”）。
将集成类型设置为“Internal”。
复制你的 API 密钥。
通过点击任何页面/数据库右上角的“...”菜单并选择“添加连接”来共享你的 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 Desktop 配置

打开 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. 重启 Claude

重启 Claude 后，你就可以开始使用了！

✨ 主要特性

该项目旨在构建一个 MCP 服务器，连接 Claude AI 和 Notion 工作区，允许 Claude：

从 Notion 数据库和页面中读取内容
更新现有内容
在整个 Notion 工作区中搜索
查询和过滤数据库条目
获取详细页面内容和数据库架构

📦 安装指南

先决条件

Node.js (v16+)
Notion API 密钥
Claude Desktop

安装步骤

见“快速开始”部分。

💻 使用示例

基础用法

该 MCP 服务器提供以下工具：

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

mcp-server-notion