更好的MCP概念
mcp名称：io.github.n24q02m/better-notion-mcp
Markdown第一个用于AI代理的Notion API服务器——10个复合工具取代28+端点调用
  ](https://www.npmjs.com/package/@n24q02m/better-notion-mcp) ](https://hub.docker.com/r/n24q02m/better-notion-mcp) 
 ](#)   
Sister projects from n24q02m (click to expand)
| 项目 | 标记线 | 标记 |
|---|---|---|
| 更好的代码审查图 | 用于令牌高效代码审查的知识图——固定搜索，可配置。.. | MCP |
| 更好的电子邮件mcp | 用于AI代理的IMAP/SMTP电子邮件服务器——6个具有多帐户的复合工具。.. | MCP |
| 更好的godot-mcp | Godot引擎的复合MCP服务器——用于AI辅助游戏开发的17大工具 | MCP |
| 更好的概念mcp | Markdown第一个用于人工智能代理的Notion API服务器——10个复合工具replacin。.. | MCP |
| 更好的电报mcp | 用于Telegram的MCP服务器，支持双模：用于快速聊天的Bot API（httpx）… | MCP |
| claude插件 | 完整文档：mcp.n24q02m.com——所有8台服务器+mc的统一文档 | |
| 想象一下mcp | 用于图像和视频理解+生成交流的生产级MCP服务器 | MCP |
| jules任务归档员 | Chrome扩展通过批执行API对Jules任务进行批量操作--a… | 工具 |
| mcp核心 | 统一MCP流式HTTP 2025-11-25传输，OAuth 2.1授权序列。.. | MCP |
| mnemo mcp | 具有混合搜索和嵌入式同步功能的持久AI内存。开放、自由、无趣。.. | MCP |
| qwen3嵌入 | 通过ONNX Runtime和GGUF | 库进行轻量级Qwen3文本嵌入和重新排序 |
| 尖叫 | 没有服务器的秘密。 | CLI |
| 网络核心 | 用于搜索、抓取、HTTP安全和存储的共享web基础架构包 | 库 |
| 湿mcp | 用于网络搜索、内容提取、库文档和多媒体的开源MCP服务器 | MCP |
目录
特性
- Markdown输入，Markdown输出 --人类可读的内容，而不是原始JSON块
- 10个复合工具 有44个操作——一个调用，而不是链接2+个原子端点
- 自动分页和批量操作 --没有手动光标处理或循环
- 分层令牌优化 --通过压缩描述+按需减少约77%
help工具 - 双重运输 --本地stdio（令牌）或远程HTTP（OAuth 2.1，无需令牌）
状态
2026-05-02——架构稳定更新 过去几个月，凭证处理和守护进程桥自动生成模式发生了重大变化。这导致了多进程竞争、浏览器标签垃圾邮件和插件之间不一致的设置用户体验。 截至v，架构稳定：2种干净模式（stdio+HTTP），没有守护进程桥层，没有从stdio自动生成。 为不稳定时期道歉。如果您在以前的版本中遇到问题，请更新到v+追随潮流 docs/setup-manual.md --不再需要大多数先前的解决方法。 来自同一作者的相关插件: - 湿mcp --网络搜索+内容提取 - mnemo mcp --持久AI记忆 - 想象一下mcp --图像/视频理解+生成 - 更好的电子邮件mcp --电子邮件管理 - 更好的电报mcp --电报 - 更好的godot-mcp --Godot引擎 - 更好的代码审查图 --代码审查知识图 所有插件共享相同的架构——安装一次，学习模式转换。文档
完整文档请访问 mcp.n24q02m.com/servers/better-notion-mcp/:
- 设置 --Claude Code、Codex、Gemini CLI、Cursor、Windsurf、mcp.json的安装方法
- 模式概述 --stdio/本地中继/远程中继/远程oauth
- 多用户设置 --根据JWT子证书模型
使用AI代理进行安装 --将此粘贴到您的AI编码代理：
安装MCP服务器 better-notion-mcp 按照以下步骤 https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-notion-mcp/setup-with-agent.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 | 文件上传参考 |
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
NOTION_TOKEN | 是（stdio） | - | 通知集成令牌 |
TRANSPORT_MODE | 没有 | stdio | 设置为 http 用于远程模式 |
PUBLIC_URL | 是（http） | - | 服务器用于OAuth重定向的公共URL |
NOTION_OAUTH_CLIENT_ID | 是（http） | - | 通知公共集成客户端ID |
NOTION_OAUTH_CLIENT_SECRET | 是（http） | - | 通知公共集成客户端机密 |
DCR_SERVER_SECRET | 是（http） | - | 用于无状态客户端注册的HMAC密钥 |
PORT | 没有 | 8080 | 服务器端口 |
自托管（远程模式）
您可以使用自己的Notion OAuth应用程序自行托管远程服务器。
先决条件：
- 创建一个 公共整合 在
- 将重定向URI设置为
https://your-domain.com/callback - 注意你的
client_id和client_secret
docker 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异常（注释.list 404，未定义的rich_text）
从源代码构建
git clone https://github.com/n24q02m/better-notion-mcp.git
cd better-notion-mcp
bun install
bun run dev信任模型
此插件实现 TC NearZK （在记忆中，转瞬即逝）。看 mcp核心/docs/TRUST-MODEL.md 进行全面分类。
| 模式 | 存储 | 加密 | 谁可以读取您的数据？ |
|---|---|---|---|
| HTTP n24q02m托管（默认） | 内存中 Map | 仅在处理中 | 服务器进程（重新启动时清除） |
| HTTP自主机 | 与托管相同 | 相同 | 只有您（管理员=用户） |
| stdio代理 | ~/.better-notion-mcp/config.json | AES-GCM，机器绑定密钥 | 仅限您的操作系统用户（文件perm 0600） |
许可证
麻省理工学院——见 许可证.