Makenotion Notion MCP Server

🚀 Notion MCP 服務器

本項目實現了一個 MCP 服務器 對接 Notion 接口，為相關應用提供支持。

🚀 快速開始

本項目可助力您實現與 Notion 接口的對接，通過 MCP 服務器進行相關操作。

📦 安裝指南

1. 在 Notion 中設置集成

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

儘管我們限制了 Notion 接口暴露的範圍（例如，您無法通過 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. 連接到數據庫

在 Notion 中 創建一個免費帳戶並創建一些數據庫。

💻 使用示例

基礎用法

命令行使用示例

echo "{
  \"messages\": [
    {
      \"role\": \"user\",
      \"content\": \"告訴我有關人工智能的內容。\"
    }
  ],
  \"model\": \"gpt-3.5-turbo\",
  \"temperature\": 0.7
}" | curl -X POST http://localhost:1234/v1/chat/completions

Python 使用示例

import requests

url = "http://localhost:1234/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
}
data = {
    "messages": [
        {"role": "user", "content": "告訴我有關人工智能的內容。"}
    ],
    "model": "gpt-3.5-turbo",
    "temperature": 0.7
}

response = requests.post(url, json=data)
print(response.json())

🔧 技術細節

開發

安裝依賴項

npm install

運行測試

npm test

構建項目

npm run build

運行服務器

npm start

⚠️ 注意事項

⚠️ 重要提示

確保您的 Notion 集成令牌具有適當的權限。

💡 使用建議

測試時使用較小的溫度值以獲得更確定的結果。