🚀 mcp-notion-server

一个用于 Notion 集成的 Model Context Protocol 服务器，此服务器基于 TypeScript 实现，搭建起了 Claude 和 Notion 之间的桥梁，实现了与 Notion 的数据库和页面进行无缝交互。其通过 Notion 资源管理、内容的 CRUD 操作工具以及基于 AI 的提示内容分析等核心 MCP 概念得以展现价值。

🚀 快速开始

这个基于 TypeScript 的 MCP 服务器实现了 Claude 和 Notion 之间的桥梁，允许与 Notion 的数据库和页面进行无缝交互。它通过以下核心 MCP 概念进行了演示：

• Notion 页面和数据库的资源管理
• 内容的增删改查（CRUD）操作工具
• 基于 AI 的提示内容分析

✨ 主要特性

资源

• 通过 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 集成：

1. 访问 Notion 的您的集成页面。
2. 点击“新建集成”。
3. 命名您的集成并选择适当的权限（例如，“读取内容”，“更新内容”）。
4. 获取 Secret Key：
5. 复制集成的“内部 Integration Token”。这个令牌将用于身份验证。
6. 将集成添加到您的工作区：
7. 在 Notion 中打开您想让集成访问的页面或数据库。
8. 点击右上角的导航按钮。
9. 点击“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，该工具作为包脚本可用：

1. MCP Inspector

npm run inspector

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE