mcp-notion-server

一个用于 Notion 集成的模型上下文协议服务器

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

• Notion 页面和数据库的资源管理
• 用于对 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 密钥和集成设置
• Claude 桌面应用程序

与 Claude 桌面集成

创建 Notion 集成：

1. 访问 Notion Your Integrations 页面。

2. 点击 "New Integration"。

3. 命名您的集成并选择适当的权限（例如，“Read content”，“Update content”）。

4. 检索密钥：

5. 从您的集成中复制 "Internal Integration Token"。 此令牌将用于身份验证。

6. 将集成添加到您的工作区：

7. 在 Notion 中打开您希望集成访问的页面或数据库。

8. 点击右上角的导航按钮。

9. 点击 "Connect to" 按钮并选择您的集成。

配置设置

将服务器配置添加到 Claude 桌面：

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