项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM 客户端（如 Claude）与 Notion API 之间的桥梁。通过此服务器，LLM 客户端可以安全、可扩展地访问和操作 Notion 工作空间中的数据，实现与 Notion 的深度集成。

主要功能点

• 工具 (Tools)： 提供了一系列预定义的工具，允许 LLM 客户端执行各种 Notion 操作，例如：
  • 数据检索： 获取 Notion 页面、块、数据库和用户的详细信息。
  • 数据操作： 创建、更新和删除 Notion 页面、块、数据库项目和评论。
  • 数据查询： 在 Notion 数据库中执行查询和搜索操作。
  • 用户管理： 列出和检索 Notion 工作区用户。
• 资源 (Resources) 和 Prompt 模板 (Prompts)： 虽然代码中没有显式提及资源和 Prompt 模板的管理，但作为 MCP 服务器，它具备扩展以支持这些功能的能力。当前版本主要侧重于工具的注册和执行。

安装步骤

1. 创建 Notion 集成:
   • 访问 Notion Your Integrations page。
   • 点击 "New Integration"。
   • 命名你的集成，并选择适当的权限（例如，"Read content", "Update content"）。
2. 获取密钥:
   • 从你的集成配置页面复制 "Internal Integration Token"。
   • 此 Token 将用于服务器的身份验证。
3. 邀请集成到工作区:
   • 在 Notion 中打开你希望集成访问的页面或数据库。
   • 点击右上角的导航按钮。
   • 点击 "Connect to" 按钮并选择你的集成。

服务器配置

要将 Notion MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件（通常是 'claude_desktop_config.json'）中添加服务器配置。以下是配置示例，你需要将 'your-integration-token' 替换为你在 Notion 集成页面获取的 "Internal Integration Token"。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

配置参数说明:

• 'server name': 'notion' (服务器名称，可以自定义，用于在客户端中引用)
• 'command': 'npx' (用于启动服务器的命令，这里使用 'npx' 运行 npm 包)
• 'args': '["-y", "@suekou/mcp-notion-server"]' (传递给 'command' 的参数，'-y' 自动确认安装包，'@suekou/mcp-notion-server' 是要运行的 npm 包名)
• 'env': '{ "NOTION_API_TOKEN": "your-integration-token" }' (环境变量配置，'NOTION_API_TOKEN' 用于传递 Notion API 密钥)

基本使用方法

1. 确保已完成上述安装步骤和服务器配置。
2. 启动 MCP 客户端（例如 Claude Desktop）。客户端会自动连接到配置的 Notion MCP Server。
3. 在 LLM 客户端中，你可以通过自然语言指令调用 Notion 相关的工具。例如，你可以询问 "Read the content of my Notion page with ID [page ID]"，客户端会调用 'notion_retrieve_page' 工具并返回结果。
4. 具体工具的使用方法和参数，请参考仓库 'README.md' 文件中 "Tools" 部分的详细描述。