Skip to main content
Glama

NoteBridge MCP

统一多平台笔记 MCP 服务器 - 一个项目管理飞书、Notion、语雀三大平台。

架构说明

NoteBridge MCP 采用单一服务器架构,将三个平台的工具整合到一个 MCP 服务器中:

┌─────────────────────────────────────────────────────────────┐
│                    Claude Code                               │
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────┐
│                 NoteBridge MCP Server                        │
│                    (73 个工具)                                │
├─────────────────────────────────────────────────────────────┤
│  飞书 (55个工具)  │  Notion (10个工具)  │  语雀 (8个工具)     │
└─────────────────────────────────────────────────────────────┘

优势:

  • ✅ 单一项目:一个 package.json,一个入口文件

  • ✅ 单一配置:一个 .mcp.json 搞定

  • ✅ 统一管理:所有工具在同一个服务器中

  • ✅ 完整功能:73 个工具覆盖三大平台


Related MCP server: mcp-multi-note

快速开始

1. 安装依赖

cd D:\notebridge-mcp
bun install

2. 配置 Token

编辑 D:\notebridge-mcp\.mcp.json,替换以下 Token:

{
  "mcpServers": {
    "notebridge": {
      "command": "C:/Users/Siat/.bun/bin/bun.exe",
      "args": ["run", "D:/notebridge-mcp/src/index.ts"],
      "env": {
        "LARK_APP_ID": "your_lark_app_id",
        "LARK_APP_SECRET": "your_lark_app_secret",
        "NOTION_API_KEY": "your_notion_token",
        "YUQUE_TOKEN": "your_yuque_token"
      }
    }
  }
}

3. 复制配置到 Claude

cp D:\notebridge-mcp\.mcp.json ~/.claude/mcp.json

4. 重启 Claude Code

关闭并重新打开 Claude Code,即可使用全部 73 个工具。


API 权限清单

飞书 (Lark) 所需权限

在 飞书开放平台 中配置:

权限

说明

用途

wiki:wiki

Wiki 读写

知识库操作

wiki:node:move

移动 Wiki 节点

节点移动

docx:document:readonly

文档只读

读取文档

docx:document

文档读写

创建/更新文档

docx:document:create

创建文档

新建文档

drive:drive

云盘操作

文件管理

bitable:app

多维表格

表格操作

task:task:read

读取任务

待办事项

task:task:write

写入任务

创建待办

task:tasklist:read

读取任务清单

清单管理

task:tasklist:write

写入任务清单

创建清单

task:section:write

任务分组

分组管理

contact:contact.base:readonly

联系人

部门成员

contact:user.base:readonly

用户信息

获取用户

contact:user.email:readonly

用户邮箱

获取邮箱

offline_access

离线访问

Token 刷新

配置步骤:

  1. 登录 飞书开放平台

  2. 进入你的应用 → 权限管理

  3. 添加上述所有权限

  4. 版本管理 → 发布新版本

  5. 重新授权

Notion 所需权限

在 Notion Integrations 中配置:

权限

说明

用途

Read content

读取内容

搜索、读取页面/数据库

Update content

更新内容

更新页面/数据库

Insert content

插入内容

创建页面/数据库

Read user information

读取用户信息

获取用户信息

配置步骤:

  1. 访问 https://www.notion.so/profile/integrations

  2. 点击 "New integration"

  3. 填写名称,选择工作区

  4. 在 Capabilities 中勾选上述权限

  5. 点击 "Submit"

  6. 复制 "Internal Integration Token"(以 ntn_ 开头)

  7. 重要:在 Notion 中连接需要访问的页面

    • 打开目标页面

    • 点击右上角 ··· → Connections

    • 选择你的 Integration

语雀 (Yuque) 所需权限

在 语雀 Token 设置 中配置:

权限

说明

用途

读取

读取知识库和文档

搜索、读取

写入

创建和更新文档

创建、更新、删除

配置步骤:

  1. 登录 https://www.yuque.com

  2. 点击右上角头像 → 账户设置

  3. 左侧菜单 → Token

  4. 点击 "新建 Token"

  5. 填写名称,选择 "读写" 权限

  6. 点击 "确定"

  7. 立即复制 Token(只显示一次)


完整工具列表

飞书工具 (55个)

认证工具 (5个)

工具

说明

lark_auth_url

自动 OAuth 授权

lark_auth

手动提交授权码

user_me

获取当前用户信息

user_get

查询指定用户

user_list

列出部门成员

Wiki 工具 (10个)

工具

说明

wiki_spaces

列出所有 Wiki 空间

wiki_list_nodes

列出 Wiki 节点

wiki_read

读取 Wiki 内容

wiki_update

更新 Wiki 内容

wiki_prepend

在 Wiki 顶部插入

wiki_append

在 Wiki 底部追加

wiki_insert_blocks

在指定位置插入

wiki_delete_blocks

删除指定范围

wiki_create_node

创建新节点

wiki_move_node

移动节点

文档工具 (16个)

工具

说明

doc_create

创建文档

doc_read

读取文档

doc_prepend

在文档顶部插入

doc_append

在文档底部追加

doc_update

更新文档

doc_delete

删除文档

doc_move

移动文档

doc_insert_blocks

在指定位置插入

doc_delete_blocks

删除指定范围

doc_move_blocks

移动块

doc_search_blocks

搜索块

doc_indent_block

缩进/取消缩进

doc_batch_update_blocks

批量更新

drive_list

列出云盘文件

drive_recent

列出最近文件

lark_search

全局搜索

格式转换工具 (1个)

工具

说明

blocks_to_markdown

Blocks 转 Markdown

待办工具 (8个)

工具

说明

todo_list

列出待办

todo_create

创建待办

todo_search

搜索待办

todo_update

更新待办

todo_add_members

添加负责人

todo_remove_members

移除负责人

task_complete

完成任务

task_delete

删除任务

任务清单工具 (7个)

工具

说明

tasklist_list

列出清单

tasklist_create

创建清单

tasklist_get

获取清单详情

tasklist_update

更新清单

tasklist_delete

删除清单

tasklist_add_task

添加任务到清单

tasklist_remove_task

从清单移除任务

tasklist_tasks

列出清单任务

子任务工具 (3个)

工具

说明

subtask_create

创建子任务

subtask_list

列出子任务

subtask_update

更新子任务

任务分组工具 (4个)

工具

说明

section_list

列出分组

section_tasks

列出分组任务

section_create

创建分组

section_delete

删除分组

Notion 工具 (22个)

工具

说明

API-post-search

搜索页面和数据库

API-retrieve-a-page

获取页面详情

API-create-a-page

创建页面

API-update-page-properties

更新页面属性

API-retrieve-a-database

获取数据库详情

API-query-a-database

查询数据库

API-create-a-database

创建数据库

API-update-a-database

更新数据库

API-retrieve-a-block

获取块详情

API-retrieve-block-children

获取子块

API-append-block-children

追加子块

API-update-a-block

更新块

API-delete-a-block

删除块

API-retrieve-a-user

获取用户详情

API-list-all-users

列出用户

API-list-comments

列出评论

API-create-a-comment

创建评论

API-retrieve-a-page-property

获取页面属性

API-retrieve-content-lake

获取内容湖

API-create-a-data-source

创建数据源

API-query-data-source

查询数据源

API-move-page

移动页面

语雀工具 (8个)

工具

说明

yuque_repo_list

列出知识库

yuque_repo_get

获取知识库详情

yuque_doc_list

列出文档

yuque_doc_get

获取文档详情

yuque_doc_create

创建文档

yuque_doc_update

更新文档

yuque_doc_delete

删除文档

yuque_search

搜索内容


使用示例

跨平台搜索

帮我搜索所有平台上关于"项目进展"的内容

Claude 会并行调用:

  • lark_search 搜索飞书

  • API-post-search 搜索 Notion

  • yuque_search 搜索语雀

内容迁移

把我 Notion 上的"产品需求文档"复制到飞书知识库

Claude 会:

  1. API-retrieve-a-page 读取 Notion 文档

  2. API-retrieve-block-children 获取内容

  3. wiki_create_node 在飞书创建页面

  4. wiki_append 写入内容

统一待办

查看我在所有平台上的待办事项

Claude 会:

  • todo_list 获取飞书待办

  • API-query-a-database 查询 Notion 数据库(如果有待办数据库)


项目结构

D:\notebridge-mcp\
├── package.json             # 统一依赖管理
├── tsconfig.json
├── README.md                # 本文档
├── .mcp.json                # MCP 配置文件
└── src/
    ├── index.ts             # 入口文件
    ├── constants.ts         # 常量配置(三个平台)
    ├── lifecycle.ts         # 生命周期管理
    ├── services/
    │   ├── lark-client.ts   # 飞书 API 客户端
    │   ├── notion-client.ts # Notion API 客户端
    │   └── yuque-client.ts  # 语雀 API 客户端
    ├── tools/
    │   ├── auth.ts          # 飞书认证工具 (5个)
    │   ├── wiki.ts          # 飞书 Wiki 工具 (10个)
    │   ├── doc.ts           # 飞书文档工具 (16个)
    │   ├── todo.ts          # 飞书待办工具 (24个)
    │   ├── notion.ts        # Notion 工具 (10个)
    │   └── yuque.ts         # 语雀工具 (8个)
    ├── schemas/
    │   ├── common.ts
    │   ├── auth.ts
    │   ├── wiki.ts
    │   ├── doc.ts
    │   └── todo.ts
    └── utils/
        ├── errors.ts
        ├── rate-limiter.ts
        ├── retry.ts
        ├── markdown.ts
        ├── oauth-callback.ts
        └── response.ts

常见问题

Q: 重启后工具没有出现?

A: 检查 ~/.claude/mcp.json 文件是否存在且格式正确。

Q: API 调用失败?

A: 检查 Token 是否有效,权限是否完整。参考上方的「API 权限清单」。

Q: 如何更新某个平台?

A: 进入对应目录执行 git pull 即可,各平台独立更新:

cd D:\lark-office-mcp && git pull
cd D:\notion-mcp-server && git pull
cd D:\yuque-mcp-server && git pull

Q: 如何添加更多平台?

A: 参考现有项目结构,创建新的 MCP 服务器,然后在 .mcp.json 中添加配置。


更新日志

v1.0.0 (2026-06-10)

  • 初始版本

  • 单一项目整合飞书、Notion、语雀三大平台

  • 73 个工具(飞书 55 + Notion 10 + 语雀 8)

  • 统一的 API 客户端和错误处理

  • 完整的权限清单和配置指南


相关项目

本项目在设计上参考了以下两个仓库:


License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server that provides OAuth-enabled integrations for multiple services through a single deployment. Currently supports Slack with 47 tools, with plans to expand to Gmail, Google Calendar, Notion, and 100+ other integrations.
    6
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI agents to search, read, and create notes across six note-taking platforms (Feishu, Obsidian, Notion, Yuque, OneNote, Evernote) through a single unified interface.
    MIT
  • A
    license
    C
    quality
    C
    maintenance
    MCP server with 23 tools for full Notion integration, enabling database, page, block, user, search, comment, template, and duplication operations through natural language.
    23
    11 npm
    MIT