Kibela MCP Server

基本能力

产品定位

Kibela MCP Server 是一个专为 Kibela 设计的 MCP 服务器，旨在通过标准化的协议提供对 Kibela 数据的访问和操作能力。

核心功能

1. 笔记操作：包括搜索笔记、获取笔记详情、创建和更新笔记内容等。
2. 文件夹操作：支持搜索文件夹、获取文件夹详情、创建文件夹以及移动笔记到不同文件夹等。
3. 评论操作：允许在笔记上创建评论及回复。
4. 其他操作：包括获取群组列表和获取 feed 部分列表等。

适用场景

• 查询 Kibela 中的信息
• 组织和整理 Kibela 中的文件夹和文章
• 使用 AI 辅助写作

工具列表

1. 笔记操作工具：
2. search_kibela_note：搜索笔记
3. get_kibela_note_by_relay_id：通过 Relay ID 获取笔记
4. create_kibela_note：创建新笔记
5. update_kibela_note_content：更新笔记内容
6. 文件夹操作工具：
7. search_kibela_folder：搜索文件夹
8. create_kibela_folder：创建新文件夹
9. move_kibela_note_to_another_folder：移动笔记到其他文件夹
10. 评论操作工具：
11. create_kibela_comment：在笔记上创建评论
12. create_kibela_comment_reply：回复评论

常见问题解答

1. 依赖问题：确保 Docker 已安装并运行，且已获取 Kibela 访问令牌。
2. 配置问题：确保正确设置 Kibela 的 origin 和 access token。
3. 自定义问题：可通过 JSON 文件自定义工具描述和提示。

使用教程

使用依赖

1. 安装 Docker
2. 确保 Docker 正在运行
3. 获取 Kibela 访问令牌
4. 安装支持 MCP 客户端 的应用程序

安装教程

使用 Docker 安装

将以下配置写入 claude_desktop_config.json，并设置 Kibela origin 和 access token 为环境变量。

{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "KIBELA_ORIGIN",
        "-e",
        "KIBELA_ACCESS_TOKEN",
        "ghcr.io/kibela/kibela-mcp-server"
      ],
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

不使用 Docker 安装

确保脚本路径为绝对路径。

{
  "mcpServers": {
    "kibela": {
      "command": "/path/to/kibela-mcp-server/bin/cli.mjs",
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

调试方式

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector \
  -e KIBELA_ORIGIN=https://your-subdomain.kibe.la \
  -e KIBELA_ACCESS_TOKEN=*** \
  docker compose exec mcp bin/cli.mjs

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。