Notion MCP Server

🚀 配置 Notion API 密鑰和權限

本項目主要用於指導用戶完成 Notion API 密鑰的創建、頁面權限的配置、代碼更新、Claude 環境設置、Notion 庫安裝以及文檔字符串的生成等操作，幫助用戶順利使用 Notion API 進行開發。

🚀 快速開始

創建 Notion API 密鑰

1. 訪問 Notion 集成：訪問 Notion 集成，並使用您的 Notion 賬戶登錄。
2. 創建新集成：點擊 "New Integration"，填寫所需的字段（例如集成名稱），然後選擇您要連接的工作區。
3. 保存集成：提交後會生成一個 API 密鑰。請將此密鑰複製並安全保存，用於後續的 API 請求認證。
4. 獲取 API 密鑰：複製生成的 API 密鑰，並確保其安全性。

配置頁面權限以使用集成

1. 打開 Notion 頁面：打開您要賦予權限的 Notion 頁面。
2. 共享頁面：點擊頁面頂部右側的 "Share" 按鈕。
3. 邀請集成：在 "Invite" 文本框中輸入您的集成名稱，並從下拉列表中選擇它。這樣可以授予該集成對頁面的訪問權限。
4. 設置權限：確保集成具有執行所需操作（例如讀取、寫入）的必要權限。

代碼更新

在 notion_sdk.py 文件中，將 PAGE_ID 更新為之前創建的頁面 ID。您可以通過複製頁面鏈接來獲取該 ID。

💻 使用示例

示例中的 Notion 頁面 ID

https://www.notion.so/MCP-Parent-Page-1d21f7216bdb80789f88fccd964b5031

Curl 示例

以下是一個使用 Notion API 創建新頁面的示例：

curl --location --request POST 'https://api.notion.com/v1/pages' \
--header 'Authorization: Bearer $NOTION_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Notion-Version: 2021-05-13' \
--data '{
"parent": { "page_id": "1d21f7216bdb80789f88fccd964b5031" },
"properties": {
    "title": [
        {
            "text": {
                "content": "新頁面標題"
            }
        }
    ]
}
'

在 Claude 中設置

安裝 uv 工具

如果您使用的是 Mac，請通過以下命令安裝：

brew install uv

驗證安裝是否成功：

uv --version

運行 Python 腳本：

uv run <script>.py

設置環境變量

在 Claude 中，您需要將 NOTION_API_KEY 添加到環境變量。例如：

export NOTION_API_KEY=your_api_key_here

或者，在配置文件中指定可執行文件路徑：

{
  "executors": {
    "default_python": {
      "command": "/usr/bin/python3",
      "env": {
        "NOTION_API_KEY": "your_api_key"
      }
    }
  }
}

安裝 Notion 庫

使用 pip 安裝 notion-client：

pip install notion-client

生成文檔字符串示例

以下是一個函數的示例 docstring，幫助 LLM 和人類理解工具的用法和參數：

示例函數及其 docstring

def get_page_content(page_id: str) -> dict:
    """
    獲取指定頁面的內容。
    
    Args:
        page_id (str): 需要獲取內容的頁面 ID
        
    Returns:
        dict: 頁面內容，包含標題和其他屬性
    """
    # 具體實現代碼

另一個示例

def create_new_page(parent_id: str, title: str) -> str:
    """
    在指定父頁面下創建新頁面。
    
    Args:
        parent_id (str): 父頁面的 ID
        title (str): 新頁面的標題
        
    Returns:
        str: 新創建頁面的 ID
    """
    # 具體實現代碼

使用注意事項

• 摘要：簡要描述函數的目的。
• 參數：詳細說明每個輸入參數及其類型和用途。
• 返回值：明確返回值的類型和含義。

通過遵循這些規範，您可以確保文檔字符串既對人友好又對模型友好。