返回 MCP 目录
public公开dns本地运行

systemprompt-mcp-notion

一个高性能的Model Context Protocol (MCP)服务器,用于将Notion集成到AI工作流中。

article

README

🚀 系统提示MCP Notion服务器

系统提示MCP Notion服务器是一款高性能的模型上下文协议(MCP)服务器,它能将Notion无缝集成到您的AI工作流程中。借助这个服务器,AI代理可以通过标准化协议与Notion页面和数据库进行交互。该服务器支持并要求使用MCP采样,这是创建和更新Notion页面所必需的MCP。

兼容的MCP客户端可在此处获取。

🚀 快速开始

先决条件

在使用此服务器之前,您需要完成以下准备工作:

  1. 系统提示API密钥(免费)
  2. Notion账户和工作区
    • 拥有活跃的Notion账户。
    • 准备一个包含要访问内容的工作区。
  3. Notion集成
    • notion.so/my-integrations创建集成。
    • 需要具备以下功能:
      • 读取/更新/插入内容。
      • 数据库管理。
      • 搜索功能。
  4. MCP兼容客户端
    • 使用此处的兼容客户端。

开发设置

  1. 克隆仓库:
git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
cd systemprompt-mcp-notion
  1. 安装依赖项:
npm install
  1. 设置环境:
cp .env.example .env
# 编辑.env文件中的API密钥

测试

我们使用Jest保持高测试覆盖率,您可以使用以下命令进行测试:

# 运行所有测试
npm test

# 开发模式下的观察模式
npm run test:watch

# 生成覆盖报告
npm run test:coverage

# 测试Notion API连接
npm run test:notion

✨ 主要特性

服务器功能

const serverCapabilities: { capabilities: ServerCapabilities } = {
  capabilities: {
    resources: {
      listChanged: true,
    },
    tools: {},
    prompts: {
      listChanged: true,
    },
    sampling: {},
  },
};

关键特性

  • 📝 内容管理全面
    • 可以创建和更新带富文本格式的页面。
    • 支持在您的Notion工作区中进行搜索。
  • 🛠 开发人员友好
    • 使用Jest进行全面测试。
    • 支持TypeScript。
    • 具备详细日志记录和调试工具。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端