Notion集成服务器

一个高性能的模型上下文协议(MCP)服务器,用于将Notion无缝集成到AI工作流程中,支持AI代理通过标准化协议与Notion页面和数据库交互。

  • by Ejb503
  • TypeScript
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 Ejb503/systemprompt-mcp-notion

使用说明

系统提示mcp概念

网站 | 文档

SystemPrompt MCP通知服务器

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

兼容的MCP客户端可用 这里.

服务器功能

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

主要特点

  • 📝 全面的内容管理

    • 创建和更新富文本格式的页面
    • 在您的Notion工作区中搜索
  • 🛠 开发者友好

    • Jest的广泛测试覆盖率
    • TypeScript支持
    • 全面的错误处理
    • 详细的日志记录和调试工具

先决条件

在使用此服务器之前,您需要:

  1. 系统提示API密钥 (免费)

  2. 概念帐户和工作区

    • 主动通知帐户
    • 包含您要访问的内容的工作区
  3. 概念整合

    • 创建时间 notion.so/my集成
    • 所需能力:
      • 阅读/更新/插入内容
      • 数据库管理
      • 搜索功能
  4. MCP兼容客户端

快速开始

  1. 安装

    通过Smithery安装

    通过以下方式自动安装Claude Desktop的systemprompt mcp概念 史密瑟里:

    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
    # 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