Notion_mcp_server

设置 Notion API 密钥和权限

创建 Notion API 密钥

1. 前往 Notion 集成页面：

   • 访问 Notion 集成页面，并使用你的 Notion 账号登录。

2. 创建新的集成：

   • 点击“New Integration”，填写所需字段，例如集成名称，并选择要连接的工作区。

3. 保存集成：

   • 填写完详细信息后，点击“Submit”以创建集成。系统会为你提供一个 API 密钥。

4. 复制 API 密钥：

   • 复制 API 密钥并妥善保管。你将使用此密钥向 Notion API 验证请求。

授予页面使用集成的权限

1. 打开 Notion：

   • 前往要授予权限的页面。

2. 分享页面：

   • 点击页面右上角的“Share”按钮。

3. 邀请集成：

   • 在“Invite”字段中输入集成的名称，并从下拉列表中选择它。这样集成便可访问该页面。

4. 设置权限：

   • 确保集成拥有执行所需操作的必要权限（例如，读取、写入）。

更新代码

在 notion_sdk.py 中，将 PAGE_ID 更新为上文创建的页面的 PAGE_ID。 复制页面链接即可获取页面 ID。

为 Python 设置 uv

1. 使用 Homebrew 安装 uv：

   • 确保系统已安装 Homebrew。
   • 运行以下命令安装 uv：

     brew install uv
     

2. 验证安装：

   • 运行以下命令，检查 uv 是否已正确安装：

     uv --version
     

3. 基本用法：

   • 可以使用 uv 运行 Python 脚本：

     uv run <your_script.py>
     

Notion 父页面 ID

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

Curl 示例

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": "Curl example"
            }
        }
    ]
}
}'

注意事项

在 Claude 中安装时，密钥需要硬编码

如何运行

uv run mcp dev server.py

在 Claude 中使用

uv run mcp install server.py

将添加到 claude_desktop_config.json

{
  "mcpServers": {
    "Notion MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "/Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/server.py"
      ],
      "env": {
        "NOTION_API_KEY": "REPLACE_ME"
      }
    }
  }
}

{
  "mcpServers": {
    "Notion MCP Server": {
"command": "bash",
"args": [
  "-c",
  "source /Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/.venv/bin/activate && uv run mcp run /Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/server.py"
      ],
      "env": {
        "NOTION_API_KEY": "TODO"
      }
    }
  }
}

Notion 包

notion-client

用于创建文档字符串的 LLM 提示词

I am building an MCP (Model Context Protocol) server in Python.
The functions I provide will be registered as tools using @mcp.tool() from FastMCP.

Please generate a concise and informative docstring for each function I give you, following this structure:
	•	A one-line summary describing the function’s purpose.
	•	A section called Args: listing each argument with its type and purpose.
	•	A section called Returns: describing the return value and its type.

The docstring should help both humans and LLMs understand how and when to use the tool.