Chemican MCP

🚀 Notion MCP 服務器

本項目實現了 MCP 協議 在 Notion API 上的服務，可助力用戶更高效地使用 Notion 進行內容管理與交互。

🚀 快速開始

本項目實現了 MCP 協議 在 Notion API 上的服務，可幫助用戶在 Notion 中更好地利用 MCP 協議進行操作。

✨ 主要特性

• 實現了 MCP 協議在 Notion API 上的服務，拓展了 Notion 的功能。
• 支持多種安裝方式，如 npm 和 Docker，方便不同用戶的需求。

📦 安裝指南

1. 在 Notion 中設置集成

訪問 https://www.notion.so/profile/integrations 創建新的 內部 集成，或選擇現有的集成。

⚠️ 重要提示

儘管我們限制了 Notion API 暴露的範圍（例如，您無法通過 MCP 刪除數據庫），但將數據暴露給 LLM 存在非零風險。注重安全的用戶可能希望進一步配置集成的 功能。

例如，您可以創建一個只讀集成令牌，僅授予“閱讀內容”權限，在“配置”選項卡中：

2. 將 MCP 配置添加到客戶端

使用 npm

將以下內容添加到您的 .cursor/mcp.json 或 claude_desktop_config.json（MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json）

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

使用 Docker

您也可以使用 Docker 運行 MCP 服務器。首先構建 Docker 鏡像：

docker-compose build

然後將以下內容添加到您的 .cursor/mcp.json 或 claude_desktop_config.json：

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server-notion-mcp-server"
      ]
    }
  }
}

⚠️ 重要提示

別忘了將 ntn_**** 替換為您自己的集成密鑰。從您的集成配置選項卡中找到：

3. 將內容連接到集成

確保相關頁面和數據庫已連接到您的集成。

為此，您需要訪問該頁面，點擊三個點，然後選擇“連接到集成”。

💻 使用示例

基礎用法

1. 使用以下指令

在頁面“Getting started”上發表評論“Hello MCP”

2. 指令示例

告訴我在頁面“Getting started”上寫一句“Hello MCP”

3. 新建頁面

創建一個新頁面，標題為“我的新頁面”，內容為“這是一個新的 Notion 頁面。”

📚 詳細文檔

開發

依賴項

• Node.js 和 npm 已安裝。

安裝

npm install -g @notionhq/notion-mcp-server

運行

notion-mcp-server --help

發佈

npm run build