使用说明

项目简介

mcp-notion-server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 Claude 等大型语言模型 (LLM) 应用与 Notion 之间的桥梁。通过这个服务器，LLM 可以安全、可扩展地访问和操作 Notion 中的页面和数据库资源，并利用预定义的工具执行诸如内容分析、数据查询等任务。

主要功能点

资源管理: 允许 LLM 通过 URI 访问 Notion 页面和数据库，支持纯文本和富文本内容类型，并提取 Notion 属性元数据。
工具 (Tools): 提供了一系列工具，使 LLM 能够对 Notion 内容执行 CRUD 操作 (创建、读取、更新、删除)。主要工具包括：
- 数据库操作: 'list_databases' (列出数据库), 'create_database' (创建数据库), 'query_database' (查询数据库), 'update_database' (更新数据库)。
- 页面操作: 'create_page' (创建页面), 'update_page' (更新页面), 'get_page' (获取页面), 'delete_page' (删除页面)。
- 块操作: 'append_blocks' (追加块), 'delete_blocks' (删除块), 'get_blocks' (获取块), 'update_blocks' (更新块)。
Prompt 模板 (Prompts): 预置了 Prompt 模板，支持 LLM 进行内容分析，例如 'summarize_notes' (总结笔记), 'analyze_content' (分析内容), 'suggest_tags' (建议标签)。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js 18 或更高版本。

安装 MCP Inspector (可选): 为了调试 MCP 服务器，建议安装 MCP Inspector。

npm install @modelcontextprotocol/inspector

配置 Notion API 密钥:
- 前往 Notion Integrations 页面创建一个新的 Integration。
- 为你的 Integration 命名并设置适当的权限（例如，"读取内容", "更新内容"）。
- 复制你的 Integration 的 "Internal Integration Token" (密钥)。
- 将你的 Integration 连接到你希望 LLM 访问的 Notion 页面或数据库。
配置 Claude Desktop:
- 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
  - MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  - Windows: '%APPDATA%/Claude/claude_desktop_config.json'
- 在 'mcpServers' 字段中添加 mcp-notion-server 的配置信息。

服务器配置

以下是添加到 'claude_desktop_config.json' 的服务器配置信息，用于 Claude Desktop 连接 mcp-notion-server。

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

配置参数说明:

'server name': 'mcp-notion-server' - 服务器名称，用于在 Claude Desktop 中标识和引用。
'command': 'npx' - 用于启动服务器的命令，这里使用 'npx' 直接运行 npm 包。
'args': '["-y", "@gabornyerges/mcp-notion-server"]' - 传递给 'command' 的参数。
- '-y': 'npx' 的参数，可能用于自动同意执行。
- '@gabornyerges/mcp-notion-server': 要执行的 npm 包名称，即 mcp-notion-server 服务器。
'env': 环境变量配置。
- 'NOTION_API_KEY': 请替换为你在 Notion Integrations 页面获取的 "Internal Integration Token" (密钥)。这是 mcp-notion-server 连接 Notion API 的凭证。

注意: 请务必将 '"your-notion-api-key"' 替换为你真实的 Notion API 密钥。

基本使用方法

配置完成后，Claude Desktop 即可通过 MCP 协议与 mcp-notion-server 通信。你可以指示 Claude 使用 'list_databases', 'create_page' 等工具来操作你的 Notion 数据。例如，你可以要求 Claude "列出我的 Notion 数据库" 或 "在我的 '项目管理' 数据库中创建一个新页面"。 Claude 将调用 mcp-notion-server 提供的工具来执行这些操作，并将结果返回给你。你还可以尝试使用预定义的 Prompt 模板，如 'summarize_notes' 来分析 Notion 中的内容。

调试: 如果遇到问题，可以使用 MCP Inspector 进行调试，运行 'npm run inspector' 命令启动 Inspector 工具。

关键词