mcp-kibela 🗒️

基本能力

产品定位

mcp-kibela 是一个连接 AI 助手与 Kibela 知识库的中间件服务，专注于提供 Kibela 内容的搜索和引用功能。

核心功能

• 笔记搜索：通过关键词搜索 Kibela 笔记
• 我的笔记：获取用户的最新笔记
• 笔记内容：通过 ID 获取笔记内容和评论
• 路径笔记：通过路径获取笔记内容
• 创建笔记：创建新笔记
• 更新笔记内容：通过笔记 ID 更新笔记内容

适用场景

1. AI 助手需要引用 Kibela 知识库中的内容时
2. 团队需要将 Kibela 知识库与 AI 工作流集成时
3. 需要自动化 Kibela 笔记创建和更新流程时

工具列表

1. Docker：用于容器化部署服务
2. Node.js：运行环境
3. MCP Client（如 Claude Desktop、Cursor 等）：客户端支持

常见问题解答

1. 如何获取 Kibela 访问令牌？ 参考 Kibela API 访问令牌获取方法
2. 如何设置 Kibela 团队名称？ 从 Kibela 团队页面 URL 获取，格式为 https://[team-name].kibe.la

使用教程

使用依赖

1. 安装 Node.js (v18 或更高版本)
2. 安装 MCP 客户端（如 Claude Desktop、Cursor 等）
3. 获取 Kibela 访问令牌
4. 安装 Git（如果从源代码构建）

安装教程

使用 Cursor

{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

使用 VSCode

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

使用 Claude Desktop

{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

使用 Smithery

npx -y @smithery/cli install @kj455/mcp-kibela --client claude

调试方式

1. 使用 npm run build:watch 以监视模式构建项目

npm run build:watch

1. 使用 MCP 检查器检查服务器

npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

环境变量

• KIBELA_TEAM: Kibela 团队名称（必需）
• KIBELA_TOKEN: Kibela API 令牌（必需）

许可证

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