systemprompt-mcp-notion

本地服务

systemprompt.io记忆与知识2688 周前更新

关于 systemprompt-mcp-notion

systemprompt-mcp-notion 是一个 MCP 服务，用于让 AI Agent 通过标准协议访问 Notion 的页面、数据库和评论。它面向在 AI 工作流中使用 Notion 的开发者，并要求 MCP Sampling 支持以创建和更新页面。

主要功能

01创建和更新带富文本格式的页面
02搜索 Notion 工作区内容
03提供 TypeScript 实现与 Jest 测试
04包含错误处理与详细日志

适用场景

01由 AI Agent 在 Notion 中创建或更新页面
02在 AI 工作流中搜索 Notion 工作区内容

MCP 相关

该项目是一个 MCP 服务，声明了 resources、tools 和 prompts 能力，供 MCP 客户端访问 Notion 内容。

#ai #mcp #systemprompt #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "systemprompt-mcp-notion": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

systemprompt-mcp-notion

网站 | 文档

SystemPrompt MCP Notion 服务

一个高性能的 Model Context Protocol (MCP) 服务，可将 Notion 无缝集成到你的 AI 工作流中。该服务使 AI Agent 能够通过标准化协议与 Notion 页面和数据库交互。该服务支持并要求 MCP Sampling，这是 MCP 创建和更新 Notion 页面所必需的。

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

服务能力

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

主要功能

📝 全面的内容管理
- 创建和更新带富文本格式的页面
- 在你的 Notion 工作区中进行搜索
🛠 对开发者友好
- 使用 Jest 提供广泛的测试覆盖
- 支持 TypeScript
- 全面的错误处理
- 详细的日志和调试工具

前提条件

使用该服务之前，你需要：

Systemprompt API Key（免费）
- 在 systemprompt.io/console 注册
- 在你的仪表板中创建一个新的 API key
Notion 账户和工作区
- 活跃的 Notion 账户
- 包含你想要访问的内容的工作区
Notion 集成
- 在 notion.so/my-integrations 创建
- 所需能力：
  - 读取/更新/插入内容
  - 数据库管理
  - 搜索功能
兼容 MCP 的客户端
- Systemprompt MCP Client
- 任何其他兼容 MCP 的客户端

快速开始

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 systemprompt-mcp-notion：

npx -y @smithery/cli install systemprompt-mcp-notion --client claude

npm install systemprompt-mcp-notion

配置创建一个 .env 文件：

SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
NOTION_API_KEY=your_notion_integration_token

MCP 配置 将以下内容添加到你的 MCP 配置 JSON 中：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["systemprompt-mcp-notion"],
      "env": {
        "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
        "NOTION_API_KEY": "your_notion_integration_token"
      }
    }
  }
}

或者，如果你已在本地安装该包：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["./node_modules/systemprompt-mcp-notion/build/index.js"],
      "env": {
        "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
        "NOTION_API_KEY": "your_notion_integration_token"
      }
    }
  }
}

开发

设置

克隆仓库：

git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
cd systemprompt-mcp-notion

安装依赖：
```
npm install
```

设置环境：

cp .env.example .env
# Edit .env with your API keys

测试

我们使用 Jest 保持高测试覆盖率：

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

# Test Notion API connection
npm run test:notion

支持 Markdown

登录后评论