STARWARCLOUD STARWAR.AI
返回市场
概念MCP

概念MCP

作者：Sjotie11 星标更新：2025-05-26
安装使用来源：spider==github.com

项目介绍

Notion MCP Server

这是一个模型上下文协议（MCP）服务器，用于连接Claude和其他AI助手到你的Notion工作区。此集成允许AI助手与你的Notion数据库、页面和内容块进行交互。

这是什么？

这个工具充当了AI助手（如Claude）与你的Notion工作区之间的桥梁。它允许AI助手：

  • 查看和搜索你的Notion数据库
  • 创建和更新页面
  • 管理内容块
  • 以及更多功能！

分步设置指南

先决条件

  • Node.js（版本14或更高）
  • 一个Notion账户
  • Claude桌面应用（如果与Claude一起使用）

1. 获取你的Notion API密钥

  1. 前往https://www.notion.so/my-integrations
  2. 点击蓝色的“+ 新集成”按钮
  3. 填写详细信息：
    • 名称：选择一个名称，如“Claude助手”或“AI助手”
    • 图标：可选
    • 关联的工作区：选择你的Notion工作区
  4. 点击“提交”
  5. 在下一页中找到“内部集成令牌”部分
  6. 点击“显示”并复制令牌（以secret_开头）

2. 设置此服务器

下载仓库

选项A：下载ZIP文件（推荐初学者）

  1. 前往GitHub仓库：https://github.com/Sjotie/notionMCP/
  2. 点击右上角绿色的“代码”按钮
  3. 选择“下载ZIP”
  4. 下载后，将ZIP文件解压到计算机上的某个位置
    • Windows：右键点击ZIP文件并选择“全部解压”
    • Mac：双击ZIP文件以解压

选项B：使用Git克隆（适用于熟悉Git的用户）

  1. 打开命令提示符或终端
    • Windows：按Win+R，输入cmd，然后按Enter
    • Mac：从应用程序 > 实用工具打开终端
  2. 导航到你想要存储仓库的位置 
    cd 路径/到/期望的位置
  3. 克隆仓库 
    git clone https://github.com/Sjotie/notionM

导航到项目目录

下载或克隆后，你需要使用cd（更改目录）命令导航到项目文件夹：

如果你下载了ZIP文件（选项A）：

  1. 打开命令提示符或终端

  2. 使用cd命令导航到你解压ZIP文件的位置：

    cd 路径/到/解压的文件夹/notionMCP

    例如：

    • 在Windows上：cd C:\Users\YourName\Downloads\notionMCP
    • 在Mac上：cd /Users/YourName/Downloads/notionMCP

如果你使用Git克隆（选项B）：

  1. 仓库应该已经被克隆到了名为“notionMCP”的文件夹中
  2. 如果你在克隆后仍然在同一终端窗口中，只需键入： 
    cd notionMCP

如何知道你是否在正确的目录中：

  • 使用cd命令后，你可以检查当前所在位置：
    • 在Windows上：键入dir并按Enter - 你应该能看到如server.js这样的文件
    • 在Mac上：键入ls并按Enter - 你应该能看到如server.js这样的文件

安装依赖项

进入notionMCP目录后，安装所需的依赖项：

npm install

这将安装所有必要的Node.js包。你应该会看到进度条，并最终得到一条消息，表明安装已完成。它可能会说类似于“X个包正在寻求资金”——这是完全正常的，意味着它已经成功运行。

3. 连接到Notion页面

出于安全考虑，Notion要求你明确授予每个页面或数据库的访问权限：

  1. 打开Notion并导航到你希望AI访问的页面或数据库
  2. 点击右上角的“•••”（三个点）
  3. 选择“添加连接”
  4. 找到并选择你之前创建的集成
  5. 对于任何其他你想让AI访问的页面或数据库，重复上述步骤

4. 连接到Claude桌面

  1. 查找你的Claude桌面配置文件：

    • Windows：%APPDATA%\Claude\claude_desktop_config.json （在文件资源管理器地址栏中输入此路径）
    • Mac：~/Library/Application Support/Claude/claude_desktop_config.json （在Finder中，按Cmd+Shift+G并粘贴此路径）

  2. 在文本编辑器中打开该文件。如果不存在，请创建它，并包含以下内容：

    {
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "C:\\路径\\到\\notion-mcp-server\\server.js"
      ],
      "env": {
        "NOTION_API_KEY": "你的Notion API密钥"
      }
    }
  }
}

  3. 替换：

    • C:\\路径\\到\\notion-mcp-server\\server.js为实际的server.js文件路径
      • Windows：在路径中使用双反斜杠（\）
      • Mac：使用正斜杠（/）
    • 你的Notion API密钥为你自己的Notion API密钥

  4. 保存文件并重新启动Claude桌面

5. 测试连接

  1. 在Claude中开始新的对话
  2. 让Claude与你的Notion工作区互动，例如：
    • “给我列出我的Notion数据库”
    • “在我的任务数据库中创建一个新页面，标题为‘测试任务’”

可用工具

服务器提供这些工具给AI助手：

  • list-databases：查看所有可访问的数据库
  • query-database：获取数据库中的条目
  • create-page：向数据库添加新页面
  • update-page：修改现有页面
  • create-database：创建新数据库
  • update-database：修改数据库结构
  • get-page：查看特定页面
  • get-block-children：查看内容块
  • append-block-children：向页面添加内容
  • update-block：编辑内容块
  • get-block：查看特定块
  • search：在整个工作区中查找内容

故障排除

常见问题：

  1. “连接失败”在Claude中

    • 确保claude_desktop_config.json中的服务器路径正确
    • 检查你的Notion API密钥是否有效
    • 确保已安装Node.js

  2. “访问被拒绝”当访问Notion内容时

    • 确保你已将页面/数据库与你的集成共享
    • 检查你的API密钥是否有必要的权限

  3. 服务器无法启动

    • 确保已安装所有依赖项（npm install）
    • 检查.env文件是否存在且包含你的API密钥

获取帮助

如果你遇到未在此处涵盖的问题，请：

  • 检查控制台输出中的错误消息
  • 确保你的Notion API密钥有效
  • 验证你的集成是否具有对页面/数据库的访问权限

许可证

MIT