baklib-mcp-server

xiaohui-zhangxh/baklib-mcp-server

3.2

If you are the rightful owner of baklib-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP Server for the Baklib API, enabling search functionalities for knowledge base articles and site pages.

Tools
1
Resources
0
Prompts
0

Baklib MCP Server

Baklib MCP Server 是一个 Model Context Protocol (MCP) 服务器，让 AI 助手可以直接访问和操作 Baklib 的资源库和知识库。

📋 功能特性

资源库（DAM）

  • 上传文件到资源库
  • 查看文件信息
  • 更新文件元数据
  • 删除文件
  • 搜索和浏览文件列表

知识库（KB）

  • 创建文章
  • 查看文章内容
  • 更新文章
  • 删除文章
  • 搜索和浏览文章列表
  • 查看知识库列表

🚀 快速开始

1. 安装配置

在 Cursor 的 .cursor/mcp.json 文件中添加以下配置：

{
  "mcpServers": {
    "baklib-mcp-server": {
      "type": "command",
      "command": "npx",
      "args": [
        "-y",
        "@baklib/baklib-mcp-server"
      ],
      "env": {
        "BAKLIB_TOKEN": "your-api-token-here",
        "BAKLIB_API_BASE": "https://open.baklib.com/api/v1"
      }
    }
  }
}

环境变量说明：

  • BAKLIB_TOKEN（必需）：你的 Baklib API 密钥对，格式为 access_key:secret_key
  • BAKLIB_API_BASE（可选）：API 基础地址，默认为 https://open.baklib.com/api/v1
    • 私有化部署用户可以通过此环境变量配置自己的 API 地址
    • 例如：https://your-domain.com/api/v1

2. 获取 API Token

  1. 登录 Baklib 后台
  2. 进入 个人中心 → API 密钥对
  3. 创建新的 API 密钥对
  4. 复制 access_key:secret_key 格式的 token，替换配置中的 your-api-token-here

3. 重启 Cursor

配置完成后，重启 Cursor 使配置生效。

💬 使用示例

配置完成后，你可以直接通过自然语言与 AI 助手对话，使用 Baklib 的功能。以下是一些示例：

资源库操作

上传文件

请帮我把 /path/to/image.jpg 上传到 Baklib 资源库

上传这个文件到资源库：/Users/me/document.pdf

查看文件信息

查看资源库中 ID 为 123456 的文件信息

更新文件信息

把资源库中 ID 为 123456 的文件名称改为"产品介绍.pdf"，描述改为"2025年产品介绍文档"

搜索文件

在资源库中搜索名称包含"产品"的文件

列出资源库中所有图片类型的文件，每页显示 20 个

删除文件

删除资源库中 ID 为 123456 的文件

知识库操作

查看知识库列表

列出我所有的知识库

显示我的知识库列表，每页 10 个

查看知识库详情

查看 ID 为 405 的知识库详情

创建文章

在知识库 405 中创建一篇文章，标题是"使用指南"，内容是"这是使用指南的内容..."

在知识库 405 中创建一篇标题为"快速开始"的文章，内容使用 Markdown 格式

查看文章

查看知识库 405 中 ID 为 212916 的文章内容

更新文章

更新知识库 405 中 ID 为 212916 的文章，把标题改为"新标题"，内容改为"新内容..."

搜索文章

在知识库 405 中搜索包含"API"的文章

列出知识库 405 中所有文章，每页 10 个

创建子文章

在知识库 405 中，在 ID 为 212916 的文章下创建一篇子文章，标题是"详细说明"

删除文章

删除知识库 405 中 ID 为 212916 的文章

组合操作示例

上传图片并创建文章

先上传 /path/to/image.jpg 到资源库，然后在知识库 405 中创建一篇文章，标题是"产品介绍"，内容中包含刚才上传的图片

批量操作

列出知识库 405 中的所有文章，然后更新每篇文章的标题，在前面加上"[2025]"

⚠️ 注意事项

  1. Token 格式：Token 格式为 access_key:secret_key，不需要 Bearer 前缀
  2. 知识库 ID：知识库在 API 中称为 "spaces"，使用 space_id 参数
  3. 文件大小：注意 Baklib API 的文件大小限制
  4. 权限：确保你的 API Token 有相应的操作权限

📚 相关链接

📝 更新日志

v0.1.0 (2025-12-15)

🎉 重大更新
  • 新增 18 个 API 工具，大幅扩展功能覆盖范围
  • 代码架构重构，将工具函数模块化，提高代码可维护性
✨ 新增功能
  • 站点管理：站点页面和标签的完整 CRUD 操作，站点信息查询
  • 用户和成员管理：用户列表、当前用户信息、成员信息查询
  • 主题管理：模板主题列表查询
  • 第三方集成：集成列表和详情查询
🔧 改进
  • 代码架构优化，每个工具函数独立为单独文件
  • 统一工具导出机制，更好的代码组织结构

详细变更请查看

v0.0.6 (2025-12-15)

  • 初始版本发布
  • 支持资源库完整功能（上传、查询、更新、删除文件）
  • 支持知识库完整功能（创建、查询、更新、删除文章，获取知识库列表）
  • 支持分页和筛选
  • 自动 MIME 类型检测

版本：0.1.0
最后更新：2025-12-15