【亲测免费】 Notion MCP 服务器使用指南

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);
});

4. 典型生态项目

目前，Notion MCP服务器可以与各种Notion生态项目配合使用，例如：

• Notion CLI工具：通过命令行与Notion交互。
• Notion桌面应用：将MCP服务器集成到桌面应用中，提供更丰富的交互体验。
• 自动化工具：利用MCP服务器进行自动化任务，如定期同步数据等。

通过上述介绍，您应该已经能够开始使用Notion MCP服务器，并探索其提供的各种功能和用途。