Kibela

🚀 Kibela MCP 服务器

Kibela MCP 服务器是一个开源项目，遵循模型上下文协议（Model Context Protocol），致力于搭建 AI 工具与 Kibela 笔记服务之间的桥梁。借助该服务器，AI 模型能借助 HTTP 协议对 Kibela 中的笔记数据进行访问和操作。

✨ 主要特性

• 搜索笔记：支持通过关键词或条件查询笔记内容。
• 创建与更新笔记：允许 AI 工具生成、编辑和管理笔记。
• 评论交互：AI 可以添加和回复笔记中的评论，增强互动性。
• 文件管理：支持附件上传及关联，提升笔记的扩展能力。
• 安全审计：确保所有操作符合安全规范，保障数据完整性。

🔧 技术细节

核心组件

工具定义

以下是 MCP 服务器中预设的关键工具及其功能描述：

• 搜索笔记
  • 功能：通过关键字或筛选条件查找特定笔记。
  • 输入格式：支持自由文本输入和结构化查询参数。
  • 输出格式：返回匹配笔记的基本信息及内容摘要。
• 创建新笔记
  • 功能：生成新的空白笔记，可指定标题、内容及所属组别。
  • 输入格式：包含标题、正文和组别标识的 JSON 对象。
  • 输出格式：返回新建笔记的唯一标识符和链接地址。
• 更新现有笔记
  • 功能：对已存在的笔记进行内容修改或扩展。
  • 输入格式：包括笔记 ID 和需要更新的内容片段。
  • 输出格式：确认更新操作成功的状态信息。
• 添加评论
  • 功能：在指定笔记下添加新的评论内容。
  • 输入格式：包含评论文本和目标笔记 ID 的数据包。
  • 输出格式：返回新评论的详细信息及关联笔记链接。

操作指南

1. 安装依赖

docker compose run mcp pnpm install

2. 启动服务

docker compose up

3. 配置环境变量
   • 设置 KIBELA_ORIGIN 为你的 Kibela 实例地址。
   • 配置 KIBELA_ACCESS_TOKEN 用于身份验证。
4. 挂载配置文件（可选）

docker compose exec mcp bin/cli.mjs \
  --config=/path/to/your/config.json

自定义配置

通过编写自定义工具描述和提示文件，可以进一步扩展服务器功能。具体步骤如下：

1. 创建一个 JSON 文件，例如 custom-config.json：

{
  "tools": {
    "search_kibela_note": {
      "description": "根据关键词搜索笔记内容"
    }
  },
  "prompts": {
    "review": {
      "prompt": "分析并总结指定链接中的笔记内容，提出改进建议。"
    }
  }
}

2. 将此配置文件挂载到 Docker 容器中：

docker run -v /path/to/custom-config.json:/config.json kibela-mcp-server

测试验证

使用 MCP Inspector 工具对服务器进行功能测试：

npx mcp-inspector \
  --origin http://localhost:3000 \
  --token your-access-token

📄 许可证

本项目采用 MIT 协议，允许自由使用、修改和分发。