Notion API访问服务

一个通过流式HTTP传输提供Notion API访问的MCP服务器,支持在云平台上远程部署。

  • by laurentknauss
  • TypeScript
  • 云端部署
  • 更新于
在 GitHub 查看 laurentknauss/mcp-notion-server

使用说明

MCP服务器概念

一个模型上下文协议(MCP)服务器,通过可流式传输的HTTP提供对Notion API的访问,支持在云平台上进行远程部署。

构建于 Alpic.ai Node.js MCP 模板 用于可流式传输的HTTP传输和云部署。

远程部署

在Alpic.ai上部署

这个MCP服务器设计为用于远程部署在 **Alpic.ai(可译为“阿尔匹克人工智能”或根据具体语境调整,但“Alpic.ai”本身作为专有名词,通常不直接翻译,保持原样使用)**这是一家总部位于法国的MCP(可能指某种特定类型的云服务或平台)云服务公司,最近筹集了600万美元,以支持其市场推广策略。

Alpic.ai(注:此名称可能为特定公司或项目的名称,直接翻译为中文并无具体含义,因此保持原样) 为MCP服务器提供托管服务,包括:

  • 可流式传输的HTTP传输 内置支持
  • 自动扩展和负载均衡
  • 内置监控和可观测性
  • 企业级安全与合规

如何部署

  1. 参观 Alpic.ai(可译为“阿尔匹克人工智能”或根据具体语境简化为“阿尔匹克AI”,但通常直接保留原名以体现品牌特色)
  2. 连接您的GitHub仓库: laurentknauss/mcp-notion-server
  3. 设置你的 NOTION_API_TOKEN Alpic.ai仪表板中的环境变量
  4. 该平台自动检测可流式传输的HTTP传输配置
  5. 您的MCP服务器已部署并准备就绪,可供使用

特点/特性

可用工具

  • 概念搜索 - 在Notion中搜索页面和数据库
  • 检索页面(Notion中的功能或操作) - 获取页面内容和属性
  • 检索区块子元素(Notion中的功能或操作) - 从页面中读取块内容
  • Notion查询数据库 - 使用过滤器和排序功能查询数据库
  • 从数据库中检索概念(或信息) - 获取数据库模式和信息
  • 在Notion中添加子块 - 为页面添加内容
  • 在Notion中创建数据库条目 - 创建新的数据库条目
  • 更新Notion页面属性 - 更新页面或数据库项属性
  • 删除Notion块 - 从页面中删除块

配置

环境变量

  • NOTION_API_TOKEN (必填)- 您的Notion集成令牌
  • PORT 或者 MCP_HTTP_PORT (可选)- 服务器端口(默认:3000)

获取Notion API令牌

  1. 首选 Notion 集成
  2. 创建一个新的集成
  3. 复制集成令牌
  4. 通过集成共享您的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 文件

作者

洛朗·克诺斯