systemprompt-mcp-notion

网站 | 文档

SystemPrompt MCP Notion 服务器

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

兼容的MCP客户端可在此处获得：这里。

服务器功能

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 自动为 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 维护高测试覆盖率：

# 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