热门搜索:
n24q02m/better-notion-mcp
n24q02m
面向Notion API的Markdown优先MCP服务器，提供10个复合工具（替代28+端点调用），专为AI代理优化，支持Markdown输入输出、批量操作及自动分页，减少77%令牌使用。
下载次数: 0状态：社区镜像维护者：n24q02m仓库类型：镜像最近更新：1 天前
Better Notion MCP
mcp-name: io.github.n24q02m/better-notion-mcp
面向AI代理的Markdown优先Notion API服务器——10个复合工具替代28+端点调用
镜像概述和主要用途
Better Notion MCP是一个面向Notion API的中间件服务器（MCP），专为AI代理设计。它通过提供复合工具简化Notion API调用，将多个原子端点操作整合为单一调用，同时采用Markdown作为主要内容格式，使AI代理能更自然地处理Notion内容。
核心功能和特性
- Markdown输入输出：使用人类可读的Markdown内容而非原始JSON块
- 10个复合工具含44个操作：单次调用替代2+个原子端点的链式调用
- 自动分页与批量操作：无需手动处理游标或循环
- 分层令牌优化：通过压缩描述和按需
help工具减少约77%的令牌使用 - 双传输模式：本地标准输入输出（需令牌）或远程HTTP（支持OAuth 2.1，无需令牌）
使用场景和适用范围
- AI代理与Notion集成的应用开发
- 需要简化Notion API调用的自动化工作流
- 需处理大量Notion内容的批量操作场景
- 对令牌使用有优化需求的AI应用
详细使用方法和配置说明
安装设置
通过AI代理——复制以下内容发送给AI代理：
请为我设置@n24q02m/better-notion-mcp。遵循此指南： https://raw.githubusercontent.com/n24q02m/better-notion-mcp/main/docs/setup-with-agent.md
手动设置——遵循docs/setup-manual.md
工具列表
| 工具 | 操作 | 描述 |
|---|---|---|
pages | create, get, get_property, update, move, archive, restore, duplicate | 创建、读取、更新和组织页面 |
databases | create, get, query, create_page, update_page, delete_page, create_data_source, update_data_source, update_database, list_templates | 数据库CRUD及数据库内页面管理 |
blocks | get, children, append, update, delete | 读取和操作块内容 |
users | list, get, me, from_workspace | 列出和检索用户信息 |
workspace | info, search | 工作区元数据和跨工作区搜索 |
comments | list, get, create | 页面和块评论 |
content_convert | markdown-to-blocks, blocks-to-markdown | 在Markdown和Notion块之间转换 |
file_uploads | create, send, complete, retrieve, list | 向Notion上传文件 |
setup | status, start, reset, complete | 通过浏览器中继进行凭证设置、状态检查、重置和重新解析 |
help | - | 获取任何工具的完整文档 |
MCP资源
| URI | 描述 |
|---|---|
notion://docs/pages | 页面操作参考 |
notion://docs/databases | 数据库操作参考 |
notion://docs/blocks | 块操作参考 |
notion://docs/users | 用户操作参考 |
notion://docs/workspace | 工作区操作参考 |
notion://docs/comments | 评论操作参考 |
notion://docs/content_convert | 内容转换参考 |
notion://docs/file_uploads | 文件上传参考 |
零配置设置
无需环境变量。首次启动时，服务器会在浏览器中打开设置页面：
- 启动服务器（通过插件、
npx或Docker） - 出现设置URL——在任何浏览器中打开
- 在引导表单中填写凭证
- 凭证会被加密并本地存储
您的凭证不会离开您的机器。中继服务器仅能看到加密数据。
对于CI/自动化，仍可使用环境变量（见下文）。
配置参数
| 变量 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|
NOTION_TOKEN | 是（标准输入输出模式） | - | Notion集成令牌 |
TRANSPORT_MODE | 否 | stdio | 设置为http启用远程模式 |
PUBLIC_URL | 是（HTTP模式） | - | 服务器的公共URL，用于OAuth重定向 |
NOTION_OAUTH_CLIENT_ID | 是（HTTP模式） | - | Notion公共集成客户端ID |
NOTION_OAUTH_CLIENT_SECRET | 是（HTTP模式） | - | Notion公共集成客户端密钥 |
DCR_SERVER_SECRET | 是（HTTP模式） | - | 用于无状态客户端注册的HMAC密钥 |
PORT | 否 | 8080 | 服务器端口 |
Docker部署示例
自托管（远程模式）
您可以使用自己的Notion OAuth应用自托管远程服务器。
前提条件：
- 在<[*]>创建公共集成**
- 设置重定向URI为
https://your-domain.com/callback - 记录您的
client_id和client_secret
bashdocker run -p 8080:8080 \ -e TRANSPORT_MODE=http \ -e PUBLIC_URL=https://your-domain.com \ -e NOTION_OAUTH_CLIENT_ID=your-client-id \ -e NOTION_OAUTH_CLIENT_SECRET=your-client-secret \ -e DCR_SERVER_SECRET=$(openssl rand -hex 32) \ n24q02m/better-notion-mcp:latest
安全特性
- OAuth 2.1 + PKCE S256：带代码挑战的安全授权
- 速率限制：HTTP传输模式下120请求/分钟/IP
- 会话所有者绑定：IP检查+待处理令牌绑定的TTL
- 空安全：处理Notion API异常（comments.list 404、未定义的rich_text等）
从源码构建
bashgit clone https://github.com/n24q02m/better-notion-mcp.git cd better-notion-mcp bun install bun run dev
许可协议
MIT——详见LICENSE。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 better-notion-mcp 镜像标签
docker pull docker.xuanyuan.run/n24q02m/better-notion-mcp:<标签>
DockerHub 原生拉取命令
docker pull n24q02m/better-notion-mcp:<标签>
更多 better-notion-mcp 镜像推荐
mcp/notion
mcp（Model Context Protocol）
官方Notion MCP服务器，通过模型上下文协议提供Notion API工具，支持创建评论、数据库、管理块和页面等19种操作，便于集成Notion功能到AI应用中。
34 次收藏10万+ 次下载
1 个月前更新
airbyte/source-notion
airbyte
暂无描述
1 次收藏10万+ 次下载
8 天前更新
notion/circleci
notion
用于CircleCI测试的公开Docker镜像，提供标准化测试环境，支持在CircleCI持续集成流程中执行各类测试任务。
1 次收藏100万+ 次下载
2 年前更新
betterstack/aws-ecs-fluent-bit
betterstack
使用Fluent Bit和FireLens从AWS ECS将日志发送至Better Stack。
1 次收藏500万+ 次下载
1 年前更新
madiator2011/better-comfyui
madiator2011
暂无描述
3 次收藏1万+ 次下载
9 个月前更新
madiator2011/better-forge
madiator2011
暂无描述
1万+ 次下载
1 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"