Notion集成协议服务器

mcp-notion-server是一个基于TypeScript的MCP服务器,实现了Claude与Notion之间的桥梁,允许无缝地与Notion的数据库和页面进行交互。它通过资源管理、CRUD操作工具和AI驱动的提示来展示核心MCP概念。

  • by gabornyergesX
  • 更新于
在 GitHub 查看 gabornyergesX/mcp-notion-server

使用说明

基本能力

产品定位

mcp-notion-server是一个用于Notion集成的模型上下文协议服务器,旨在通过AI增强Notion的内容管理和分析能力。

核心功能

  • 资源管理:通过URI访问Notion页面和数据库,支持纯文本和富文本内容类型,以及从Notion属性中提取元数据。
  • 工具:
    • 数据库操作:列出、创建、查询和更新数据库。
    • 页面操作:创建、更新、获取和删除页面。
    • 块操作:追加、删除、获取和更新块内容。
  • 提示:生成笔记摘要、内容分析和标签建议。

适用场景

  • 自动化Notion内容管理
  • AI驱动的Notion内容分析和摘要生成
  • 集成Notion与AI工具如Claude

使用教程

使用依赖

  • Node.js 18或更高版本
  • Notion API密钥和集成设置
  • Claude桌面应用程序

安装教程

  1. 创建Notion集成:

    • 访问Notion集成页面。
    • 点击"New Integration"。
    • 命名集成并选择适当的权限(如"Read content"、"Update content")。
    • 复制"Internal Integration Token"用于认证。
    • 将集成添加到工作空间。
  2. 配置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:

npm run inspector