mcp-kibela 🗒️

一个模型上下文协议 (MCP) 服务器实现，使 AI 助手能够搜索和引用 Kibela 内容。此设置允许像 Claude 这样的 AI 模型安全地访问存储在 Kibela 中的信息。

功能 🚀

mcp-kibela 服务器提供以下功能：

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

---

前提条件 📋

在开始之前，请确保您已具备：

• Node.js (v18 或更高版本)
• MCP 客户端 (Claude Desktop, Cursor 等)
• Kibela 访问令牌 (如何获取令牌)
• Git (如果从源代码构建)

安装 🛠️

与 Cursor 一起使用

{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "您的团队名称，来自 https://[team-name].kibe.la",
      "KIBELA_TOKEN": "您的令牌"
    }
  }
}

与 VSCode 一起使用

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela 团队名称",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela 令牌",
        "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": "您的团队名称，来自 https://[team-name].kibe.la",
        "KIBELA_TOKEN": "您的令牌"
      }
    }
  }
}

使用 Smithery

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

环境变量

需要以下环境变量：

• KIBELA_TEAM: 您的 Kibela 团队名称 (必需)。您可以从您的 Kibela 团队页面的 URL 中找到它。例如：https://[team-name].kibe.la
• KIBELA_TOKEN: 您的 Kibela API 令牌 (必需)

贡献

欢迎任何贡献！

开发

1. 使用 npm run build:watch 在观察模式下构建项目。

npm run build:watch

2. 使用 npx @modelcontextprotocol/inspector 检查 MCP 服务器。

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

许可证 📄

MIT