Chatmooc Notion MCP Server

MCP文档知识

提供方 Leonx01

文档知识 stdio · 本地进程 Token 社区 / 第三方 Claude
查看接入方式

支持多租户架构的Notion MCP服务器,允许通过HTTP请求头动态传入Notion API Token,使多个用户可以连接各自的Notion工作区。

一句话选型结论

按资料字段整理

Chatmooc Notion MCP Server 属于文档知识类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

多租户TypeScript本地部署Notion集成API代理认证服务SaaS工具

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install langchain-mcp-adapters langgraph python-dotenv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Chatmooc Notion MCP Server当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Leonx01上游标注的维护方 Leonx01
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.7 KB
来自项目仓库与上游目录的原文,未做删改

Notion MCP Server (Multi-Tenant Fork)

支持多租户架构的 Notion MCP Server。与官方版本不同,本分支允许通过 HTTP 请求头动态传入 Notion API Token,使多个用户可以连接各自的 Notion 工作区,无需为每个用户部署独立实例。

核心特性

  • 多租户支持 - 每个请求可携带不同 Notion Token
  • 双认证模式 - 支持分离认证(生产)和合并认证(开发)
  • HTTP 传输 - Streamable HTTP 模式,便于 Web 应用集成
  • LangGraph 兼容 - 完美支持 langchain-mcp-adapters

快速开始

Docker 部署

本项目提供两个 Docker Compose 配置,对应两种认证方式:

方式一:分离认证(生产/多租户)

使用 docker-compose.yml:```yaml
services:
notion-mcp-server:
build: .
ports:
- "3000:3000"
command: ["--transport", "http", "--port", "3000", "--auth-token", "your-mcp-secret"]


启动:```bash
docker compose -f docker-compose.yml up -d

特点:
- 需要 --auth-token 设置 MCP 服务器认证密钥
- 客户端需提供两个 Header:Authorization(MCP认证)+ X-Notion-Token(Notion认证)
- 适合多租户场景,一个服务支持多个 Notion 用户

方式二:合并认证(开发/单用户)

使用 docker-compose.simple.yml:```yaml
services:
notion-mcp-server:
build: .
ports:
- "3000:3000"
command: ["--transport", "http", "--port", "3000", "--disable-auth"]


启动:```bash
docker compose -f docker-compose.simple.yml up -d

特点:
- 使用 --disable-auth 关闭 MCP 服务器认证
- 客户端只需一个 Header:Authorization: Bearer
- 适合个人开发测试

> 注意:两种方式都不需要设置 NOTION_TOKEN 环境变量,Token 通过请求头动态传入!

本地运行```bash

npm install
npm run build
npm start -- --transport http --port 3000 --auth-token your-mcp-secret


---

## 两种认证方式详解

本服务支持两种认证模式,根据你的使用场景选择:

### 方式一:分离认证(推荐用于生产/多租户)

**原理**:MCP 服务器认证 和 Notion API 认证 完全分离```
┌─────────────┐  Authorization  ┌─────────────┐  X-Notion-Token  ┌─────────────┐
│  LangGraph  │ ──────────────> │  MCP Server │ ───────────────> │  Notion API │
│   Client    │  (你的服务密钥)  │   (本服务)   │  (用户Notion密钥) │   (官方)    │
└─────────────┘                 └─────────────┘                  └─────────────┘

Headers:
- Authorization: Bearer —— 验证有权连接此 MCP 服务器(由 --auth-token 参数设置)
- X-Notion-Token: —— 验证有权访问哪个 Notion 工作区(每个用户不同)

cURL 示例:```bash
curl -H "Authorization: Bearer your-mcp-secret" \
-H "X-Notion-Token: ntn_xxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' \
http://localhost:3000/mcp


**LangGraph 示例**:```python
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

# 用户 A 使用自己的 Notion Token
client_a = MultiServerMCPClient({
"notion": {
"transport": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer your-mcp-secret",      # 固定,你的服务密钥
"X-Notion-Token": "ntn_user_a_token"            # 变化,用户A的Notion
}
}
})
tools_a = await client_a.get_tools()
agent_a = create_react_agent("claude-sonnet-4-6", tools_a)

# 用户 B 使用不同的 Notion Token,同一个服务器
client_b = MultiServerMCPClient({
"notion": {
"transport": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer your-mcp-secret",      # 相同的服务密钥
"X-Notion-Token": "ntn_user_b_token"            # 不同的Notion密钥
}
}
})
tools_b = await client_b.get_tools()
# ... 操作用户 B 的 Notion

适用场景:
- ✅ SaaS 应用,多个用户各自连接自己的 Notion
- ✅ 团队协作平台,按用户区分权限
- ✅ 共享 MCP 服务基础设施


方式二:合并认证(开发便利)

原理:直接用 Notion Token 作为 Bearer Token,一举两得```
┌─────────────┐ Authorization ┌─────────────┐ (same token) ┌─────────────┐
│ LangGraph │ ──────────────> │ MCP Server │ ──────────────> │ Notion API │
│ Client │ (notion token) │ (本服务) │ │ (官方) │
└─────────────┘ └─────────────┘ └─────────────┘


**Headers**:
- `Authorization: Bearer ` —— 既是 MCP 认证又是 Notion 认证

**cURL 示例**:```bash
curl -H "Authorization: Bearer ntn_xxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' \
http://localhost:3000/mcp

LangGraph 示例:```python
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

client = MultiServerMCPClient({
"notion": {
"transport": "http",
"url": "http://localhost:3000/mcp",
"headers": {

直接用 Notion Token 作为 Bearer,省一个 Header

"Authorization": "Bearer ntn_xxxxx"
}
}
})
tools = await client.get_tools()
agent = create_react_agent("claude-sonnet-4-6", tools)

调用工具搜索 Notion

result = await agent.ainvoke({
"messages": [{"role": "user", "content": "列出我的数据库"}]
})


**适用场景**:
- ✅ 个人开发测试
- ✅ 单机部署,只服务一个用户
- ✅ 快速原型,懒得配置两个 Token

---

## 对比总结

| 特性 | 方式一(分离) | 方式二(合并) |
|------|--------------|--------------|
| Headers 数量 | 2 个 | 1 个 |
| 多租户支持 | ✅ 支持 | ❌ 不支持 |
| 部署方式 | 一个服务 + 多用户 | 一个服务 + 一个用户 |
| 安全性 | 🔒 高(服务密钥不暴露) | ⚠️ 中(Notion Token 即服务密钥)|
| 适用场景 | 生产/SaaS | 开发/个人 |

---

## 测试验证

1. 启动 Docker:```bash
docker compose -f docker-compose.simple.yml up -d
  1. 创建 .env 文件:```
    NOTION_TOKEN=ntn_xxxxx
    MCP_SERVER_URL=http://localhost:3000/mcp

3. 安装依赖并运行测试:```bash
pip install langchain-mcp-adapters langgraph python-dotenv
python test_langgraph.py

预期输出:```

Test: Call Notion Tool

Notion Token: ntn_z59972...

Getting tools...
[OK] Got 22 tools

Calling tool: API-post-search

[OK] Found 1 results:
Page: ChatMOOC

[OK] Tool call test passed!


> **注意**:工具列表中的 `Error Responses: 400: Bad...` 是 OpenAPI 文档中的**错误说明**,不是实际错误。

---

## 获取 Notion Token

1. 访问 Notion Integration
2. 创建 **Internal Integration**
3. 复制 Token(格式 `ntn_xxxx`)
4. 在目标页面点击「...」→「Connect to integration」授权

---

## 命令行参数```bash
Options:
--transport      传输模式: stdio 或 http (默认: stdio)
--port         HTTP 模式端口 (默认: 3000)
--auth-token    MCP 连接认证 Token(方式一必需,方式二可选)
--disable-auth         禁用认证(仅开发使用)
--help, -h             显示帮助

原项目

基于 Notion 官方 MCP Server 修改。

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Chatmooc Notion MCP Server 怎么安装?

在客户端按下面的安装命令接入:pip install langchain-mcp-adapters langgraph python-dotenv。装完在客户端配置里引用同一个包或端点。

Chatmooc Notion MCP Server 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Chatmooc Notion MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Chatmooc Notion MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Chatmooc Notion MCP Server 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Chatmooc Notion MCP Server 能提供哪些能力?

资料显示能力标签包括 多租户、认证服务、TypeScript、Claude、API代理。具体工具清单以官方文档为准。

Chatmooc Notion MCP Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Chatmooc Notion MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。