什么是mcp-server-notion?

mcp-server-notion是一个中间件服务，它作为Notion知识库的前端接口，允许开发者或用户通过编程方式搜索和获取存储在Notion中的文章内容。它简化了从Notion获取内容的过程，无需直接处理复杂的API调用。

如何使用mcp-server-notion?

使用前需要配置Notion API密钥，然后可以通过简单的HTTP请求或命令行工具来搜索文章或获取特定文章内容。支持多种输出格式以适应不同需求。

适用场景

适用于需要将Notion作为内容管理系统的场景，如博客平台、文档中心、知识库应用等。特别适合需要将Notion内容集成到其他应用中的开发项目。

主要功能

文章搜索支持关键词搜索Notion数据库中的文章，可限制返回结果数量

内容获取根据文章ID获取完整或部分内容，支持多种输出格式(JSON/Markdown/纯文本)

优势与局限性

优势

简化Notion API的复杂调用过程

提供统一的接口访问Notion内容

支持多种输出格式，适应不同使用场景

局限性

依赖Notion API的权限和速率限制

需要预先配置Notion集成和数据库权限

目前仅支持文章内容的获取，不支持复杂页面结构

如何使用

获取Notion集成令牌

在Notion开发者设置中创建集成，并获取API令牌

配置环境变量

设置NOTION_API_TOKEN环境变量为您的集成令牌

运行服务

启动MCP服务器，它将监听指定端口等待请求

使用案例

构建个人博客使用Notion作为博客后台，通过mcp-server-notion获取文章内容展示在前端

企业知识库搜索为内部知识库添加搜索功能，快速找到相关文档

常见问题

需要什么样的Notion权限?

支持哪些Notion内容类型?

是否有速率限制?

🚀 mcp-server-notion

mcp-server-notion 是一个 MCP 服务器，借助 Notion API 可在 Notion 数据库中搜索文章，并获取文章内容。它以 Notion 作为内容源，让您能通过编程方式便捷地获取所需文章信息。

🚀 快速开始

先决条件

Python 3.13 或更高版本
完成 Notion API 集成设置并具备相应权限
拥有 Notion 集成令牌

配置

您需要在环境变量中配置 Notion API 令牌，示例如下：

NOTION_API_TOKEN=your_notion_integration_token

✨ 主要特性

可在 Notion 数据库中搜索文章
支持获取文章的全文或部分内容

💻 使用示例

基础用法

`notion_search`

该工具可用于在 Notion 数据库中搜索文章，支持传入搜索关键词和结果最大数量。示例代码如下：

# 假设这里有调用 notion_search 的代码
# 例如：
# result = notion_search(query="example_query", limit=10)
# 这里只是示例，实际代码需根据具体实现编写

`notion_get_article`

此工具用于获取指定文章 ID 的文章内容，并可指定输出格式。示例代码如下：

# 假设这里有调用 notion_get_article 的代码
# 例如：
# article_content = notion_get_article(article_id="example_id", format="json")
# 这里只是示例，实际代码需根据具体实现编写

高级用法

您可以根据实际需求组合使用这两个工具，例如先搜索文章，再获取搜索结果中某篇文章的详细内容。示例代码如下：

# 先搜索文章
search_result = notion_search(query="advanced_query", limit=5)
# 假设搜索结果中的第一篇文章是我们想要的
first_article_id = search_result[0]['id']
# 获取该文章的详细内容
article_content = notion_get_article(article_id=first_article_id, format="markdown")