mcpField
P
pageworkspace

pageworkspace

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 pageworkspace

pageworkspace 是通过 Notion REST API 访问 Notion 页面、数据库和块的 MCP 服务。它提供一组核心工具，工具名和通信行为与所述 Notion MCP 服务相同，但不包含其托管 OAuth 接口。

主要功能

  1. 01搜索 Notion 内容
  2. 02读取和更新页面
  3. 03创建页面和数据库
  4. 04查询数据库
  5. 05读取并追加块内容
  6. 06删除块

适用场景

  1. 01搜索项目路线图页面
  2. 02通过 MCP 客户端更新页面
  3. 03查询数据库并查看条目

MCP 相关

它向 MCP 客户端提供 12 个用于操作 Notion 页面、数据库和块的工具。调用通过 Notion REST API 完成，并需要内部集成密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-pageworkspace": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/pageworkspace"
      ]
    }
  }
}
启动命令npx -y @reneturcios/pageworkspace

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/pageworkspace0.1.0
ocighcr.io/cloudcorprecords/pageworkspace:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
querystring否可选搜索文本，用于匹配页面和数据库标题；省略时返回最近项目。
page_sizenumber否每页返回结果数的可选上限。

详细介绍

pageworkspace

将 Notion 页面、数据库和区块作为 MCP 工具，通过 Notion REST API 进行交互。pageworkspace 是对 Notion MCP 服务核心功能的 全新实现，采用新名称：工具名称和线路行为相同，代码全新编写，不复制品牌元素。原版是托管的 远程 MCP 服务；此重建版本是同一上游 API 的兼容 REST 客户端，不包含托管版 OAuth 功能。

工具（核心子集，12 个）

search、list_users、get_page、create_page、update_page、 get_database、query_database、create_database、get_block、 get_block_children、append_block_children、delete_block。

此子集不包含：页面属性项端点、评论、文件上传、数据源（2025 API）、同步区块和模板管理、 托管版按数据源搜索工具，以及 OAuth 公共集成流程。

设置

在 Notion 中创建一个内部集成，将目标页面和数据库共享给该集成，并设置其密钥：

export NOTION_API_KEY=secret_...

也可通过 NOTION_API_URL 覆盖 API 基础 URL（默认值为 https://api.notion.com/v1）。如果未设置密钥，每次工具调用都会失败，并提示缺少该变量。

命令行

npx @reneturcios/pageworkspace search '{"query":"roadmap"}'
npx @reneturcios/pageworkspace mcp        # stdio MCP server

每个工具名称都是一个子命令，接收一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "pageworkspace": {
      "command": "npx",
      "args": ["-y", "@reneturcios/pageworkspace", "mcp"],
      "env": { "NOTION_API_KEY": "secret_..." }
    }
  }
}

Docker

docker run -i -e NOTION_API_KEY ghcr.io/cloudcorprecords/pageworkspace

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。