返回 MCP 目录
public公开dns本地运行

notion-mcp-server

一个基于MCP协议的Notion API服务,将Notion SDK功能转化为工具集,使LLM能通过自然语言操作Notion内容。

article

README

🚀 @orbit-logistics/notion-mcp-server

本项目是一个基于模型上下文协议(MCP)构建的服务器,完整复刻了Notion API SDK的功能,能让大型语言模型(LLMs)与Notion实现无缝交互。

🚀 快速开始

@orbit-logistics/notion-mcp-server 基于Model Context Protocol (MCP) 构建,将整个Notion API作为一系列工具对外开放。借助它,LLMs可直接通过自然语言指令完成读取、创建、更新和删除Notion页面等操作。

✨ 主要特性

  • 基于MCP构建,复刻Notion API SDK功能。
  • 允许LLMs通过自然语言指令与Notion交互。

📦 安装指南

在使用此服务器与Cursor或Claude Desktop之前,您需要先创建一个Notion集成并授予其对页面的访问权限。请按照Notion文档中的指南进行操作,并添加必要的权限: Notion集成入门指南

💻 使用示例

与Cursor一起使用

要在Cursor中集成@orbit-logistics/notion-mcp-server,请按照以下步骤操作:

  1. 打开Cursor设置。
  2. 导航到功能部分,向下滚动找到“MCP服务器”。
  3. 点击“添加新MCP服务器”。
  4. 输入自定义名称,并选择“命令”类型。
  5. 在命令字段中输入以下内容(请将<notion_integration_token>替换为您的实际令牌):
npx -y @orbit-logistics/notion-mcp-server -t <notion_integration_token>

此命令使用您的Notion集成令牌启动服务器,Cursor即可通过该MCP服务器调用Notion的API工具。

与Claude Desktop一起使用

对于Claude Desktop,MCP服务器配置存储在JSON配置文件中。将以下内容添加到claude_desktop_config.json文件中(请将<notion_integration_token>替换为您的实际令牌):

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequential-thinking-test",
        "-t",
        "<notion_integration_token>"
      ]
    }
  }
}

此配置允许Claude Desktop调用Notion的MCP服务器以实现与Notion的交互。

📄 许可证

本项目采用MIT License授权。

🤝 贡献

欢迎贡献!请随时提出问题或提交拉取请求,分享您的建议和改进。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端