使用说明
MCP服务器概念
一个模型上下文协议(MCP)服务器,通过可流式传输的HTTP提供对Notion API的访问,支持在云平台上进行远程部署。
构建于 Alpic.ai Node.js MCP 模板 用于可流式传输的HTTP传输和云部署。
远程部署
在Alpic.ai上部署
这个MCP服务器设计为用于远程部署在 **Alpic.ai(可译为“阿尔匹克人工智能”或根据具体语境调整,但“Alpic.ai”本身作为专有名词,通常不直接翻译,保持原样使用)**这是一家总部位于法国的MCP(可能指某种特定类型的云服务或平台)云服务公司,最近筹集了600万美元,以支持其市场推广策略。
Alpic.ai(注:此名称可能为特定公司或项目的名称,直接翻译为中文并无具体含义,因此保持原样) 为MCP服务器提供托管服务,包括:
- 可流式传输的HTTP传输 内置支持
- 自动扩展和负载均衡
- 内置监控和可观测性
- 企业级安全与合规
如何部署
- 参观 Alpic.ai(可译为“阿尔匹克人工智能”或根据具体语境简化为“阿尔匹克AI”,但通常直接保留原名以体现品牌特色)
- 连接您的GitHub仓库:
laurentknauss/mcp-notion-server - 设置你的
NOTION_API_TOKENAlpic.ai仪表板中的环境变量 - 该平台自动检测可流式传输的HTTP传输配置
- 您的MCP服务器已部署并准备就绪,可供使用
特点/特性
可用工具
- 概念搜索 - 在Notion中搜索页面和数据库
- 检索页面(Notion中的功能或操作) - 获取页面内容和属性
- 检索区块子元素(Notion中的功能或操作) - 从页面中读取块内容
- Notion查询数据库 - 使用过滤器和排序功能查询数据库
- 从数据库中检索概念(或信息) - 获取数据库模式和信息
- 在Notion中添加子块 - 为页面添加内容
- 在Notion中创建数据库条目 - 创建新的数据库条目
- 更新Notion页面属性 - 更新页面或数据库项属性
- 删除Notion块 - 从页面中删除块
配置
环境变量
NOTION_API_TOKEN(必填)- 您的Notion集成令牌PORT或者MCP_HTTP_PORT(可选)- 服务器端口(默认:3000)
获取Notion API令牌
- 首选 Notion 集成
- 创建一个新的集成
- 复制集成令牌
- 通过集成共享您的Notion页面/数据库
技术细节
- 构建于 TypeScript 和 快递
- 使用官方 @modelcontextprotocol/sdk(注:这通常指的是一个软件开发工具包或SDK的命名空间或包名,直接翻译为中文可能不具有实际意义,但可理解为“@模型上下文协议/软件开发工具包”或保持原样作为技术术语使用) 用于可流式传输的HTTP传输
- 用途 Notion的官方API 带有认证功能
- 需要 Node.js 20 及以上版本
- 完全兼容MCP协议规范
- 返回 JSON 格式的响应
本地开发
# Install dependencies
pnpm install
# Build
pnpm build
# Start server (requires NOTION_API_TOKEN environment variable)
NOTION_API_TOKEN=your_token_here pnpm start
# Development with hot reload
NOTION_API_TOKEN=your_token_here pnpm dev
服务器默认将在3000端口启动(可通过配置进行调整) PORT 或者 MCP_HTTP_PORT 环境变量)。
许可证
MIT 许可证 - 详情请参阅 LICENSE 文件
作者
洛朗·克诺斯