Notion集成协议服务器

一个为Notion集成设计的模型上下文协议(MCP)服务器,为AI助手提供对Notion工作区的安全访问。

  • by MostafaSwaisy
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 MostafaSwaisy/notion-mcp-server

使用说明

MCP服务器概念

用于Notion集成的模型上下文协议(MCP)服务器,为AI助手提供对Notion工作区的安全访问。

特性

  • 页面管理:创建、读取、更新和存档Notion页面
  • 搜索:在您的Notion工作区中搜索
  • 区块操作:附加块并管理页面内容
  • 用户管理:访问工作区用户和权限
  • 资源提供程序:将Notion内容作为MCP资源公开

设置

  1. 安装依赖项:

    npm install
    
  2. 设置Notion API:

  3. 配置环境:

    cp .env.example .env
    # Edit .env with your Notion API key
    
  4. 通过集成共享页面:

    • 转到您的Notion页面
    • 分享→ 添加联系人→ 查找您的集成→ 邀请

用法

发展

npm run dev

生产

npm run build
npm start

MCP检验员测试

npx @modelcontextprotocol/inspector

可用工具

  • notion_get_page:按ID检索页面
  • notion_create_page:创建新页面
  • notion_update_page:更新现有页面
  • notion_search:搜索工作区内容
  • notion_append_blocks:向页面添加块
  • notion_get_users:获取工作区用户
  • notion_archive_page:存档页面

资源

  • notion://pages:工作区中的最近页面
  • notion://page/{id}:具体页面内容

与Claude Desktop集成

添加到您的Claude Desktop配置中:

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["path/to/notion-mcp-server/dist/index.js"],
      "env": {
        "NOTION_API_KEY": "your_token_here"
      }
    }
  }
}