MCP Notion

MCP Notion

site icon
2025.03.20 0
RustNotion 集成API 中间件交流协作开发效率
MCP-Notion 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Notion API 进行集成。它提供了 HTTP 端点,允许用户与 Notion 的数据库和页面进行交互。该服务支持搜索、获取页面内容、查询数据库等功能,并具备 CORS 支持、健壮的错误处理和集成日志记录。
View on GitHub

Overview

基本能力

产品定位

MCP-Notion 是一个中间件服务,旨在简化与 Notion API 的交互,提供了一套易于使用的 HTTP 接口。

核心功能

  • Búsqueda en Notion: 支持在 Notion 中进行搜索。
  • Obtención de páginas y contenido: 获取 Notion 页面及其内容。
  • Consulta de bases de datos: 查询 Notion 数据库。
  • Soporte para CORS: 支持跨域资源共享。
  • Manejo de errores robusto: 健壮的错误处理机制。
  • Logging integrado: 集成日志记录功能。

适用场景

  • 需要与 Notion 数据库和页面进行交互的应用程序。
  • 需要自动化处理 Notion 数据的开发项目。
  • 需要集成 Notion 功能的第三方服务。

工具列表

  • curl: 用于测试 API 端点的命令行工具。
  • Rust: 用于编译和运行服务的编程语言。
  • Notion API: 提供与 Notion 交互的 API。

常见问题解答

  • 如何获取 Notion API Key? 需要在 Notion 的开发者设置中生成。
  • 如何配置环境变量? 复制 .env.example.env 并填写必要的变量。
  • 如何调试服务? 使用 RUST_LOG 环境变量设置日志级别。

使用教程

使用依赖

  • Rust (última versión estable): 最新稳定版本的 Rust。
  • Token de API de Notion: Notion API 的访问令牌。
  • Base de datos o páginas en Notion: 需要交互的 Notion 数据库或页面。

安装教程

  1. 克隆仓库:
git clone https://github.com/GsusFC/MCP-Notion.git
cd MCP-Notion
  1. 配置环境变量:
cp .env.example .env
# 编辑 .env 并添加你的 NOTION_API_KEY
  1. 编译并运行:
cargo build
cargo run

调试方式

  • 启动服务后,可以使用 curl 命令测试 API 端点。
  • 设置 RUST_LOG 环境变量以调整日志级别:
export RUST_LOG=debug
cargo run

许可证

该项目遵循 MIT 开源许可条款。