JinDaGe - mcp-notion-server MCP Details

article

README

🚀 mcp-notion-server

这是一个用于 Notion 集成的 Model Context Protocol 服务器，它基于 TypeScript 实现了 Claude 和 Notion 之间的桥梁，可让用户与 Notion 的数据库和页面进行无缝交互。通过核心 MCP 概念，它能实现 Notion 页面和数据库的资源管理、内容的增删改查（CRUD）操作，以及基于 AI 的提示内容分析。

🚀 快速开始

这个基于 TypeScript 的 MCP 服务器搭建了 Claude 和 Notion 之间的桥梁，让用户能与 Notion 的数据库和页面无缝交互。借助核心 MCP 概念，实现了资源管理、内容操作及提示内容分析等功能。

✨ 主要特性

资源

通过 URI 访问 Notion 页面和数据库。
支持纯文本和富文本内容类型。
提取 Notion 属性的元数据。

工具

数据库操作

list_databases - 列出所有可访问的 Notion 数据库。
create_database - 创建具有自定义属性的新数据库。
query_database - 搜索和过滤数据库条目。
update_database - 修改数据库属性和架构。

页面操作

create_page - 在数据库或子页面中创建新页面，支持标题、属性和 Markdown 内容。
update_page - 更新现有页面属性。
get_page - 获取页面内容和元数据。
delete_page - 从数据库或父页面删除页面。

块操作

append_blocks - 向页面添加新块。
delete_blocks - 从页面中删除块。
get_blocks - 检索块内容。
update_blocks - 修改现有块内容。

提示语

summarize_notes - 生成笔记的简洁摘要。
analyze_content - 提供页面内容的见解和分析。
suggest_tags - 根据内容推荐相关标签。

📦 安装指南

先决条件

Node.js 18 或更高版本。
Notion API Key 和集成设置。
Claude Desktop 应用程序安装。

与 Claude Desktop 集成

创建一个 Notion 集成：

访问 Notion 的您的集成页面。
点击“新建集成”。
命名您的集成并选择适当的权限（例如，“读取内容”，“更新内容”）。
获取 Secret Key：复制集成的“内部 Integration Token”，这个令牌将用于身份验证。
将集成添加到您的工作区：在 Notion 中打开您想让集成访问的页面或数据库，点击右上角的导航按钮，点击“Connect to”按钮并选择您的集成。

配置设置

将服务器配置添加到 Claude Desktop： MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

配置内容：

{
  "mcpServers": {
   "mcp-notion-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gabornyerges/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_KEY": "your-notion-api-key"
      }
    }
  }
}

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们建议使用 MCP Inspector，该工具作为包脚本可用：

MCP Inspector

npm run inspector

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE

mcp-notion-server