什麼是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")