项目简介
Notion MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,旨在为大型语言模型 (LLM) 提供与 Notion 工作空间无缝集成的能力。通过此服务器,LLM 可以利用标准化的工具来搜索、读取、创建和更新您的 Notion 页面,从而扩展 LLM 在知识管理和信息处理方面的应用。
主要功能点
- 搜索页面: 允许 LLM 在您的 Notion 工作空间中执行关键词搜索,快速找到相关页面。
- 读取页面: 使 LLM 能够读取指定 Notion 页面的内容,获取页面内的文本信息。
- 创建页面: 支持 LLM 在 Notion 工作空间中创建新的页面,可以指定标题和内容。
- 更新页面: 允许 LLM 向现有 Notion 页面追加或修改内容,实现动态内容更新。
安装步骤
-
克隆仓库 打开终端,执行以下命令克隆仓库到本地:
git clone https://github.com/MCP-Mirror/v-3_notion-server.git cd v-3_notion-server -
安装依赖 确保您已安装 Node.js (v16 或更高版本) 和 npm。在项目根目录下运行以下命令安装项目依赖:
npm install -
配置 Notion API 密钥 在项目根目录下创建 '.env' 文件,并添加您的 Notion API 密钥。您需要在 Notion 官方网站上创建集成并获取密钥。
NOTION_API_KEY=您的_Notion_API_密钥请将 '您的_Notion_API_密钥' 替换为您实际的 Notion API 密钥。
-
构建服务器 运行以下命令构建服务器代码:
npm run build构建成功后,会在项目根目录下生成 'build' 文件夹,其中包含编译后的服务器代码。
服务器配置
要将 Notion MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例,展示如何配置 Notion MCP Server:
{ "mcpServers": { "notion": { "command": "node", "args": ["/absolute/path/to/v-3_notion-server/build/index.js"] } } }
配置参数说明:
- '"notion"': 服务器名称,您可以自定义,用于在客户端中标识该服务器。
- '"command"': 启动服务器的命令,这里使用 'node' 命令来运行 JavaScript 代码。
- '"args"': 启动命令的参数,指向服务器入口文件 'build/index.js' 的绝对路径。请将 '/absolute/path/to/v-3_notion-server' 替换为您本地仓库的实际绝对路径。
注意: 您需要在 Claude Desktop 或其他 MCP 客户端的配置文件中,根据实际情况修改 'args' 中的路径,确保指向 'build/index.js' 文件的正确位置。 'NOTION_API_KEY' 环境变量已经在您的 '.env' 文件中配置,服务器运行时会自动读取。
基本使用方法
-
启动服务器: 当您在 MCP 客户端(如 Claude Desktop)中配置并启动 Notion MCP Server 后,服务器会在后台运行。
-
使用工具: 在 MCP 客户端中,您可以调用以下工具与您的 Notion 工作空间进行交互:
- 'search_pages': 用于搜索 Notion 页面。
- 'read_page': 用于读取 Notion 页面内容。
- 'create_page': 用于创建新的 Notion 页面。
- 'update_page': 用于更新现有 Notion 页面内容。
具体工具的使用方法和参数,请参考仓库 'README.md' 文件中 "Available Tools" 部分的说明。您可以在 MCP 客户端的界面或通过指令来调用这些工具,从而实现 LLM 对 Notion 工作空间的访问和操作。
信息
分类
生产力应用