Notionbae

NotionBae是一个基于.NET C#构建的Model Context Protocol服务器，用于实现AI助手与Notion.com的无缝集成，提供搜索、创建和获取Notion页面内容等功能。

知识管理与记忆开发者工具 #Notion集成 #AI助手 #数据同步 #MCP服务 .C#

评分 : 2分

下载量 : 6.4K

更新时间 : 2025-04-28

打开站点

什么是NotionBae?

NotionBae是一款基于.NET C#构建的MCP服务器，它通过Notion API为大型语言模型（LLMs）提供了与Notion数据库、页面和内容的无缝交互能力。

如何使用NotionBae?

通过简单的配置和命令，您可以轻松地让AI助手与您的Notion工作区进行协作。无论是搜索页面、创建新页面还是获取具体内容，NotionBae都能满足需求。

适用场景

适用于需要自动化管理Notion任务的企业和个人用户，比如知识库维护、项目跟踪以及团队协作。

主要功能

搜索页面

根据关键词快速查找Notion中的相关页面并返回其标题和URL。

创建新页面

支持自定义标题、描述和Markdown格式的内容来生成新的Notion页面。

获取页面详情

通过指定页面ID检索特定页面的所有内容。

提取块内容

将指定块或页面的子元素转换为Markdown格式以便于编辑和分享。

优势

简化AI助手与Notion之间的交互流程。

支持丰富的结构化数据处理能力。

确保操作的安全性和权限控制。

局限性

需要预先配置Notion API密钥。

可能对网络环境有一定依赖性。

如何使用

注册Notion账户

前往Notion官网注册账号并登录。

创建Notion集成

在Notion开发者中心创建一个新的内部集成，并记录生成的API密钥。

安装NotionBae

克隆NotionBae仓库并在本地环境中运行dotnet build命令。

配置VS Code

编辑VS Code设置文件，添加NotionBae服务器配置。

启动服务器

启动VS Code中的MCP服务器或直接通过dotnet run命令运行。

使用案例

搜索页面示例

演示如何使用nb_search函数查找特定关键词的相关页面。

创建新页面示例

展示如何利用nb_create_page函数新建一个包含Markdown内容的页面。

常见问题

NotionBae是否免费使用？

如何更新Notion API密钥？

NotionBae支持哪些操作系统？

🚀 NotionBae

NotionBae 是一个用于 Notion.com 集成的 Model Context Protocol (MCP) 服务器，采用 .NET C# 构建，基于 ModelContextProtocol。它借助 Notion API 实现大型语言模型与 Notion 工作区的无缝交互，为用户带来便捷的使用体验。

🚀 快速开始

1. Notion 账户设置

创建 Notion 账户：若尚未拥有 Notion 账户，可访问 notion.so 进行注册。
创建 Notion 集成：
- 访问 Notion Developers。
- 点击“新建集成”。
- 为集成命名（例如：“NotionBae”）。
- 选择要使用该集成的工作区。
- 设置适当的权限（至少选择“读取内容”和“更新内容”）。
- 点击“提交”完成集成创建。
获取 Notion API 密钥：在 Notion 工作区设置中创建集成，可参考 Notion API 文档了解具体创建集成和获取 API 密钥的方法。

2. 安装与运行

克隆仓库：

git clone https://github.com/mrcunninghamz/NotionBae.git
cd NotionBae

安装依赖项：

dotnet restore

运行服务器：

dotnet run

3. 配置环境变量

请确保设置以下环境变量：

NotionApiKey：用于与 Notion API 进行身份验证的 Notion API 密钥。

4. 使用说明

通过 VS Code 启动：
- 打开“命令面板”（Mac: Cmd + Shift + P，Windows/Linux: Ctrl + Shift + P）。
- 输入“MCP: 启动服务器”并从下拉列表中选择。
- 在可用服务器列表中选择“NotionBae”。
直接在命令行运行：

dotnet run

✨ 主要特性

集成 Notion API，实现与 Notion 平台的无缝对接。
提供 MCP 兼容的服务器实现。
能够对 Notion 内容进行结构化处理。
具备安全访问 Notion 工作区的身份验证机制。

📚 详细文档

可用工具

NotionBae 提供了以下工具用于与 Notion 进行交互：

工具名称	描述	参数
nb_search	搜索 Notion 页面并返回其标题和公共 URL	`query`: String - 用于查找匹配页面的搜索查询
nb_create_page	使用给定的标题、描述和内容创建新的 Notion 页面	`parentId`: String - 父页面 ID `title`: String - 页面标题 `description`: String - 页面描述 `content`: String - 页面的 Markdown 内容
nb_get_page	通过页面 ID 检索 Notion 页面	`pageId`: String - 要检索的页面 ID
nb_retrieve_block_children	检索指定块或页面 ID 的子块，并将其转换为 Markdown。即获取 Notion 页面或块的内容并转换为 Markdown	`blockId`: String - 用于检索内容的块或页面 ID