项目简介

Kibela MCP 服务器是一个基于 Model Context Protocol (MCP) 标准构建的后端应用，专为 Kibela 团队协作平台设计。它允许支持 MCP 协议的 LLM 客户端（如 Claude Desktop, VSCode 集成等）直接访问、搜索和管理 Kibela 上的文档、文件夹和评论等内容。

主要功能点

该服务器通过实现一系列 MCP 工具和 Prompt 模板，为 LLM 提供了与 Kibela 深度集成、进行智能交互的能力：

• 笔记操作: 搜索笔记、按ID或路径/URL获取笔记、获取文件夹内的笔记、创建笔记、更新笔记内容。
• 文件夹操作: 搜索文件夹、按ID或路径/URL获取文件夹、获取文件夹列表、创建文件夹、移动笔记到其他文件夹、关联笔记到文件夹。
• 评论操作: 在笔记下创建评论、创建评论回复。
• 其他: 获取群组列表、获取动态（Feed）列表。
• Prompt 模板: 提供用于笔记回顾、搜索、查找相关笔记、评论反馈等预设 Prompt 模板，简化LLM的交互流程。

安装步骤

要运行 Kibela MCP 服务器，您需要：

1. 安装 Docker 并确保其正在运行。
2. 在您的 Kibela 账户设置中生成 个人访问令牌 (Access Token)。
3. 安装一个支持 MCP 协议的客户端应用，例如 Claude Desktop 或相应的 VSCode 扩展。

服务器可以通过 Docker 容器或直接执行脚本方式运行。在客户端配置时，您需要指定相应的启动命令和环境变量。

服务器配置

MCP 服务器是为 MCP 客户端提供服务的。您需要在您的 MCP 客户端（例如 Claude Desktop）中添加 Kibela MCP 服务器的配置。这个配置通常是一个 JSON 对象，至少需要指定服务器的启动方式（'command' 和 'args'）以及连接 Kibela 所需的环境变量（'env'）。

核心配置参数：

• 'name': 服务器的名称，客户端会显示此名称，例如 "kibela"。
• 'command': 启动 MCP 服务器的命令。如果是使用 Docker 容器，通常是 '"docker"'。如果直接执行脚本，则是脚本的绝对路径。
• 'args': 启动命令的参数列表。使用 Docker 时，这里包含运行容器的命令、传递环境变量的参数 ('-e KIBELA_ORIGIN', '-e KIBELA_ACCESS_TOKEN') 以及容器镜像名称 ('ghcr.io/kibela/kibela-mcp-server')。直接执行脚本时，可能是脚本本身的参数。
• 'env': 一个包含环境变量键值对的对象。您需要在这里设置 'KIBELA_ORIGIN' (您的 Kibela 子域名 URL，如 'https://your-subdomain.kibe.la') 和 'KIBELA_ACCESS_TOKEN' (您在 Kibela 中生成的个人访问令牌)。

请查阅您使用的 MCP 客户端的文档，了解如何添加和配置自定义 MCP 服务器。

基本使用方法

配置并启动 Kibela MCP 服务器后，您的 MCP 客户端将能够检测到该服务器并显示其提供的工具和 Prompt。您现在可以通过 LLM 客户端的界面或交互方式，调用这些工具来执行 Kibela 相关的任务。例如，您可以直接在 LLM 的对话中，要求它“搜索 Kibela 中关于 [某个主题] 的笔记”，LLM 将通过 Kibela MCP 服务器调用 'search_kibela_note' 工具并返回结果。