Notion MCP 服务器使用指南

最新推荐文章于 2025-05-05 09:18:48 发布

晏宇稳

最新推荐文章于 2025-05-05 09:18:48 发布

阅读量676

点赞数 7

本文链接：https://blog.csdn.net/gitblog_00958/article/details/147137119

版权

Notion MCP 服务器使用指南

mcp-notion-server 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-notion-server

1. 项目介绍

Notion MCP 服务器是一个开源项目，它为Notion API提供了一种MCP（Markdown Conversion Protocol）服务，使得LLM（大型语言模型）能够与Notion工作空间进行交互。通过将API响应转换为Markdown格式，该项目能够有效减少token的使用，优化交互效率。

2. 项目快速启动

环境准备

在开始之前，确保你的系统中已经安装了Node.js环境。

克隆项目

通过以下命令克隆项目到本地：

git clone https://github.com/suekou/mcp-notion-server.git

安装依赖

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

cd mcp-notion-server
npm install

配置环境变量

在项目根目录下创建或编辑.env文件，设置Notion API的集成令牌：

NOTION_API_TOKEN=your-integration-token

启动服务

运行以下命令启动MCP服务器：

npm start

3. 应用案例和最佳实践

集成Markdown转换

为了减少token消耗，可以在.env文件中设置NOTION_MARKDOWN_CONVERSION为true来启用Markdown转换功能：

NOTION_MARKDOWN_CONVERSION=true

在请求工具时，可以通过设置format参数为markdown或json来控制响应格式：

使用"markdown"获取更适合阅读的输出。
使用"json"获取原始数据结构，以便程序处理。

示例代码

下面是一个示例代码，展示如何通过MCP服务器请求Notion API：

const { notionClient } = require('./src/client/index');

// 获取页面信息
notionClient.notion_retrieve_page({
  page_id: 'your-page-id',
  format: 'markdown' // 或者 'json'
}).then(response => {
  console.log(response);
}).catch(error => {
  console.error(error);
});