Notion Extra MCP Server

Notion额外MCP服务器

](https://www.npmjs.com/package/@ayatec/notion-extra-mcp-server)  

补充官方Notion MCP服务器的MCP服务器。 它提供9种工具，包括数据库查询、模式管理、批量操作、关系管理和内容追记。

交付工具

query-database --数据源查询

查询带有筛选排序的数据源。也支持在compact模式下将响应压缩到约1/10，只取得件数的count模式。

｜参数｜类型｜必需｜默认｜说明｜ | ------------------- | -------- | ---- | ----------- | -------------------------------------------------------------- | | data_source_id ｜string｜是｜-｜数据源ID｜ | filter ｜object｜否｜ノtion API过滤器对象｜ | sorts ｜object\[\]｜否｜排序条件的排列｜ | page_size |编号|否| 100 每页获取次数（最多100个） | start_cursor ｜string｜否｜页面目标光标｜ | filter_properties ｜string\[\]否｜要检索的属性（既可以指定名称也可以指定ID。令牌效率提高） | compact |boolean |否| false 通过元数据排除+属性平坦化进行压缩 | output_mode |string |否| "results" | "results"：页面列表/ "count"：仅限件数

get-data-source-schema --架构检索

获取数据源的架构（属性列表和类型信息）。

｜参数｜类型｜必需｜说明｜ | ---------------- | ------ | ---- | --------------- | | data_source_id ｜string｜是｜数据源ID｜

update-data-source-schema --架构更新

更新数据源的架构（属性定义）。

｜参数｜类型｜必需｜说明｜ | ---------------- | ------ | ---- | -------------------------- | | data_source_id ｜string｜是｜数据源ID｜ | properties 是｜属性定义对象｜

注意：select/multi_select的options必须指定所有选项（省略的选项将被删除）。不能更改status属性的name/options。

archive-page --页面存档

将页面存档（移动到垃圾桶）。也可用于删除数据库行。

｜参数｜类型｜必需｜说明｜ | ---------- | ------ | ---- | --------- | | page_id ｜string｜是｜页ID｜

batch-update-pages -- 一括更新

批量更新多页属性。考虑到速率限制（3req/s），依次执行。

｜参数｜类型｜必需｜说明｜ | ---------- | -------- | ---- | -------------------------------------------------------- | | updates 是，更新列表（最多50个）。每个元素都有page_id和properties

find-by-unique-id -- unique_id 検索

使用unique_id（自动编号ID）获取数据库中的一个页面。完全一致，100%正确。

｜参数｜类型｜必需｜默认｜说明｜ | ----------------- | ------- | ---- | ---------- | ---------------------------------------------- | | data_source_id ｜string｜是｜-｜数据源ID｜ | unique_id |string |是|-| "TASK-255" 啊 "SPEC-12" 像这样的ID字符串 | compact |boolean |否| false ｜属性平坦化｜ | include_content |boolean |否| false 也返回页面正文（Markdown）

modify-relation --关系更改

在关系属性中添加或删除页面。自动检索现有值并更新差异，因此没有覆盖风险。

｜参数｜类型｜必需｜说明｜ | ------------ | -------- | ---- | ---------------------------------------------- | | page_id ｜string｜是｜对象页ID｜ | property ｜string｜是｜关系属性名称｜ | add_ids 是否-要添加的页标识数组（自动跳过重复项） | remove_ids ｜string\[\]否｜要删除的页标识的数组｜

add_ids 或 remove_ids 中选择所需的墙类型。两者都可以同时指定。

append-content --尾随页面

在页面末尾添加标记内容。不涉及任何现有内容。

｜参数｜类型｜必需｜说明｜ | ---------- | ------ | ---- | ---------------------------- | | page_id ｜string｜是｜对象页ID｜ | content 是：要追记的标记内容

batch-fetch-pages --多页成批检索

批量获取多页详细信息。考虑到速率限制（3req/s），依次执行。

｜参数｜类型｜必需｜默认｜说明｜ | ----------------- | -------- | ---- | ---------- | ------------------------------ | | page_ids ｜string\[\]是｜-｜页面标识数组（最多50个）｜ | compact |boolean |否| false ｜属性平坦化｜ | include_content |boolean |否| false 也返回页面正文（Markdown）

安装，安装

1. Notion Internal Integration の作成

1. 概念整合 访问
2. 单击“新建集成”
3. 输入名称并选择目标工作区
4. 设置所需权限：

- 读取内容：查询数据库，获取数据源架构，按唯一id查找，批量获取页面に必要 - 更新内容：更新数据源架构、存档页面、批量更新页面、修改关系、附加内容に必要

1. 单击保存显示的标记（ntn_ ），模板名称将采用不同的格式

2.允许访问数据库

在要操作的数据库页面上：

1. 单击右上角的“…”菜单
2. 连接>选择已创建的集成名称
3. 单击确认

3. MCP设定

在npx中使用时（推荐）

克劳德代码

claude mcp add notion-extra npx @ayatec/notion-extra-mcp-server -e NOTION_TOKEN=ntn_your-token

Claude Desktop/其他MCP客户端

{
  "mcpServers": {
    "notion-extra": {
      "command": "npx",
      "args": ["@ayatec/notion-extra-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_your-token"
      }
    }
  }
}

在本地构建中使用时

git clone https://github.com/ayatec/notion-extra-mcp-server.git
cd notion-extra-mcp-server
cp .env.example .env
# .env を編集して NOTION_TOKEN を設定
pnpm install
pnpm build

克劳德代码

claude mcp add notion-extra node /path/to/notion-extra-mcp-server/dist/index.js -e NOTION_TOKEN=ntn_your-token

Claude Desktop/其他MCP客户端

{
  "mcpServers": {
    "notion-extra": {
      "command": "node",
      "args": ["/path/to/notion-extra-mcp-server/dist/index.js"],
      "env": {
        "NOTION_TOKEN": "ntn_your-token"
      }
    }
  }
}

开発

命令

pnpm install        # 依存パッケージインストール
pnpm build          # ビルド
pnpm dev            # ウォッチモードでビルド
pnpm start          # サーバー起動（ビルド後）
pnpm dev:tool       # ツールの手動テスト
pnpm test           # テスト実行
pnpm test:watch     # テスト（ウォッチモード）
pnpm type-check     # 型チェック
pnpm lint           # ESLint実行
pnpm lint:fix       # ESLint自動修正
pnpm format         # Prettier実行
pnpm format:check   # フォーマットチェック

局部测试

pnpm dev:tool 中所述修改相应参数的值。

# スキーマ取得
pnpm dev:tool get_data_source_schema --data_source_id "ds-xxx"

# データベースクエリ（compact モード）
pnpm dev:tool query_database --data_source_id "ds-xxx" --compact true --page_size 10

# フィルタ付きクエリ
pnpm dev:tool query_database --data_source_id "ds-xxx" --filter '{"property": "Status", "select": {"equals": "Done"}}'

# 件数のみ取得
pnpm dev:tool query_database --data_source_id "ds-xxx" --output_mode count

# unique_id で検索
pnpm dev:tool find_by_unique_id --data_source_id "ds-xxx" --unique_id "TASK-255" --compact true

# ページ末尾に追記
pnpm dev:tool append_content --page_id "page-xxx" --content "## 追記セクション"

# リレーション追加
pnpm dev:tool modify_relation --page_id "page-xxx" --property "関連" --add_ids '["target-page-id"]'

# 複数ページ一括取得
pnpm dev:tool batch_fetch_pages --page_ids '["page-1", "page-2"]' --compact true

# スキーマ更新
pnpm dev:tool update_data_source_schema --data_source_id "ds-xxx" --properties '{"NewProp": {"rich_text": {}}}'

# ページアーカイブ
pnpm dev:tool archive_page --page_id "page-xxx"

# 一括更新
pnpm dev:tool batch_update_pages --updates '[{"page_id": "p1", "properties": {"Name": {"title": [{"text": {"content": "New"}}]}}}]'

发布

变更集 对较大场景进行渲染期间已观察到该故障。

1. 创建changeset文件并在main中push
2. GitHub Actions自动CHANGELOG更新版本凹凸npm publish

技术栈

• TypeScript （ESM、NodeNext、严格）
• MCP-SDK --Model Context Protocol服务器实施
• API通知 --Node.js内置fetch直接访问
• 黄道带 --架构验证
• Vitest --测试
• 变更集 --版本控制CHANGELOG自动生成

许可证

麻省理工学院