systemprompt-mcp-notion

网站 | 文档

SystemPrompt MCP Notion 服务器

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

一个兼容的 MCP 客户端可在此处获得：here。

<a href="https://glama.ai/mcp/servers/xe6grtrr0k"><img width="380" height="200" src="https://glama.ai/mcp/servers/xe6grtrr0k/badge" alt="SystemPrompt Notion Server MCP server" /></a>

服务器功能

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

主要特性

• 📝 全面的内容管理

  • 创建和更新具有富文本格式的页面
  • 在您的 Notion 工作区中搜索

• 🛠 开发者友好

  • 使用 Jest 进行广泛的测试覆盖
  • TypeScript 支持
  • 完善的错误处理
  • 详细的日志记录和调试工具

前提条件

在使用此服务器之前，您需要：

1. Systemprompt API 密钥 (免费)

   • 在 systemprompt.io/console 注册
   • 在您的仪表板中创建一个新的 API 密钥

2. Notion 帐户和工作区

   • 活跃的 Notion 帐户
   • 具有您想要访问的内容的工作区

3. Notion 集成

   • 在 notion.so/my-integrations 创建
   • 所需功能：
     • 读取/更新/插入内容
     • 数据库管理
     • 搜索功能

4. MCP 兼容客户端

   • Systemprompt MCP Client
   • 任何其他 MCP 兼容客户端

快速开始

1. 安装

   通过 Smithery 安装

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

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

   npm install systemprompt-mcp-notion
   

2. 配置 创建一个 .env 文件：

   SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
   NOTION_API_KEY=your_notion_integration_token
   

3. 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"
         }
       }
     }
   }
   

开发

设置

1. 克隆存储库：

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

2. 安装依赖项：

   npm install
   

3. 设置环境：

   cp .env.example .env
   # 使用您的 API 密钥编辑 .env
   

测试

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

# 运行所有测试
npm test

# 开发的监视模式
npm run test:watch

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

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