systemprompt-mcp-notion

网站 | 文档

SystemPrompt MCP Notion 服务器

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

兼容的MCP客户端可以在这里找到。

<a href="https://glama.ai/mcp/servers/xe6grtrr0k"><img width="380" height="200" src="https://gips0.baidu.com/it/u=580228926,2045308578&fm=3081&app=3081&f=PNG?w=760&h=400" alt="SystemPrompt Notion 服务器 MCP 服务器" /></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 客户端
   • 任何其他兼容MCP的客户端

快速开始

1. 安装

   通过 Smithery 安装

   要通过Smithery自动安装systemprompt-mcp-notion以供Claude Desktop使用：

   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
   # 编辑.env文件以包含您的API密钥
   

测试

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

# 运行所有测试
npm test

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

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

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