Kibela MCP Server

Kibela MCP Server

site icon
2025.04.17 3
TypeScriptKibela API 集成内容管理团队协作交流协作
Kibela MCP Server 是一个用于 Kibela API 集成的 MCP 服务器实现,使 LLMs(大型语言模型)能够与 Kibela 内容进行交互。它提供了搜索笔记、获取最新笔记以及获取笔记内容和评论等功能,适用于需要与 Kibela 内容集成的自动化场景。
View on GitHub

Overview

基本能力

产品定位

Kibela MCP Server 主要用于 Kibela API 的集成,使 LLMs 能够与 Kibela 内容进行交互,适用于内容管理和协作场景。

核心功能

  • 搜索笔记:根据查询条件搜索 Kibela 笔记。
  • 获取最新笔记:获取用户最新的 Kibela 笔记。
  • 获取笔记内容和评论:获取指定笔记的详细内容和评论。

适用场景

  • 自动化内容管理:通过 LLMs 自动搜索和获取 Kibela 笔记内容。
  • 团队协作:集成到团队协作工具中,方便成员快速访问和共享笔记内容。

工具列表

  1. kibela_search_notes:根据查询条件搜索 Kibela 笔记,返回匹配的笔记列表(包含 ID、标题和 URL)。
  2. kibela_get_my_notes:获取用户最新的 Kibela 笔记,支持设置返回数量(默认 15 条)。
  3. kibela_get_note_content:获取指定笔记的详细内容和评论,返回 HTML 格式的内容。

常见问题解答

  • 如何配置 Kibela MCP Server? 需要设置环境变量 KIBELA_TEAM(Kibela 团队名称)和 KIBELA_TOKEN(Kibela API 令牌)。
  • 如何与 Claude Desktop 集成?claude_desktop_config.json 中添加 MCP 服务器配置。
  • 如何与 Cursor 集成?~/.cursor/config.json 中添加 MCP 服务器配置,并确保服务器 URL 设置为 http://localhost:3000/sse(SSE 传输)。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 获取 Kibela API 令牌和团队名称。

安装教程

  1. 通过 npm 安装 Kibela MCP Server: bash npm install -g @kiwamizamurai/mcp-kibela-server
  2. 配置环境变量: bash export KIBELA_TEAM="your-team" export KIBELA_TOKEN="your-token"

调试方式

  1. 启动服务器: bash npx @kiwamizamurai/mcp-kibela-server
  2. 验证服务器是否正常运行: bash curl http://localhost:3000/sse
  3. 使用工具测试功能:
  4. 搜索笔记: bash curl -X POST http://localhost:3000/kibela_search_notes -d '{"query":"example"}'
  5. 获取最新笔记: bash curl -X POST http://localhost:3000/kibela_get_my_notes -d '{"limit":10}'
  6. 获取笔记内容: bash curl -X POST http://localhost:3000/kibela_get_note_content -d '{"id":"note-id"}'

许可证

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