MCP 服务器

Notion_mcp_server

grainne-b

开发者工具

访问服务器

README

设置 Notion API 密钥和权限

创建 Notion API 密钥

前往 Notion Integrations：
- 访问 Notion Integrations 并使用您的 Notion 帐户登录。
创建新的集成：
- 点击“New Integration”，填写必填字段，例如集成的名称，并选择要连接的工作区。
保存集成：
- 填写详细信息后，点击“Submit”以创建集成。您将获得一个 API 密钥。
复制 API 密钥：
- 复制 API 密钥并安全地存储它。您将使用此密钥来验证您对 Notion API 的请求。

授予页面使用集成的权限

打开 Notion：
- 导航到您要授予权限的页面。
共享页面：
- 点击页面右上角的“Share”按钮。
邀请集成：
- 在“Invite”字段中，键入集成的名称，然后从下拉列表中选择它。这将授予集成对页面的访问权限。
设置权限：
- 确保集成具有执行所需操作的必要权限（例如，读取、写入）。

代码更新

在 notion_sdk.py 中，使用上面创建的页面的 PAGE_ID 更新 PAGE_ID。页面 ID 可以通过复制页面链接来检索

设置 Python 的 `uv`

使用 Homebrew 安装 uv：
- 确保您的系统上已安装 Homebrew。
- 运行以下命令来安装 uv：
```
brew install uv
```
验证安装：
- 运行以下命令检查 uv 是否已正确安装：
```
uv --version
```
基本用法：
- 您可以使用 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 创建文档字符串

我正在用 Python 构建一个 MCP（模型上下文协议）服务器。
我提供的函数将使用 FastMCP 中的 @mcp.tool() 注册为工具。

请为我提供的每个函数生成简洁且信息丰富的文档字符串，遵循以下结构：
	•	一个单行摘要，描述函数的功能。
	•	一个名为 Args 的部分：列出每个参数及其类型和目的。
	•	一个名为 Returns 的部分：描述返回值及其类型。

文档字符串应帮助人类和 LLM 理解如何以及何时使用该工具。