Kibela MCP Server 使用说明

项目简介

Kibela MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型 (LLM) 与 Kibela 知识管理平台。通过此服务器，LLM 可以安全地访问和利用 Kibela 中的知识内容，从而增强 LLM 在知识检索、内容理解等方面的能力。

主要功能点

搜索笔记 (kibela_search_notes): 允许 LLM 通过关键词在 Kibela 中搜索相关笔记，快速找到所需信息。
获取最新笔记 (kibela_get_my_notes): 允许 LLM 获取用户在 Kibela 中的最新笔记列表，了解最新的知识动态。
获取笔记内容 (kibela_get_note_content): 允许 LLM 获取指定 Kibela 笔记的详细内容和评论，深入理解笔记的上下文信息。

安装步骤

安装 Node.js 和 npm: 确保你的开发环境中已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 使用 Git 克隆 Kibela MCP Server 仓库到本地：

git clone https://github.com/kiwamizamurai/mcp-kibela-server.git

进入项目目录: 导航到克隆下来的项目目录：

cd mcp-kibela-server

安装依赖: 使用 npm 安装项目依赖：
```
npm install
```
构建项目: 编译 TypeScript 代码到 JavaScript：
```
npm run build
```

服务器配置

MCP 客户端 (如 Cursor 或 Claude Desktop) 需要配置以下信息来连接 Kibela MCP Server。以下是 JSON 格式的配置示例，你需要根据你的 MCP 客户端进行相应的配置：

Cursor 配置示例 (~/.cursor/config.json):

{
  "mcp": {
    "servers": {
      "kibela": {
        "command": "node",
        "args": ["dist/src/index.js"],
        "env": {
          "KIBELA_TEAM": "your-kibela-team-name",  // 替换为你的 Kibela 团队名称
          "KIBELA_TOKEN": "your-kibela-api-token"    // 替换为你的 Kibela API Token
        }
      }
    }
  }
}

Claude Desktop 配置示例 (claude_desktop_config.json):

{
  "mcpServers": {
    "kibela": {
      "command": "npx",
      "args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
      "env": {
        "KIBELA_TEAM": "your-kibela-team-name",  // 替换为你的 Kibela 团队名称
        "KIBELA_TOKEN": "your-kibela-api-token"    // 替换为你的 Kibela API Token
      }
    }
  }
}

配置参数说明:

'server name': 'kibela' (服务器名称，客户端据此名称识别和调用)
'command': 'node' 或 'npx' (启动服务器的命令)
'args': '["dist/src/index.js"]' 或 '["-y", "@kiwamizamurai/mcp-kibela-server"]' (命令参数，指定服务器入口文件或 npm 包)
'env': 环境变量配置，包含 Kibela API 访问所需的凭据：
- 'KIBELA_TEAM': 你的 Kibela 团队名称 (请替换 'your-kibela-team-name')
- 'KIBELA_TOKEN': 你的 Kibela API Token (请替换 'your-kibela-api-token')，你需要在 Kibela 后台生成 API Token

基本使用方法

启动服务器: 根据你选择的 MCP 客户端配置，启动 Kibela MCP Server。如果使用 Cursor 配置中的 'command: "node"', 则需要在项目根目录下执行 'node dist/src/index.js'。如果使用 Claude Desktop 配置中的 'command: "npx"', 则 Claude Desktop 会自动启动服务器。
配置 MCP 客户端: 将上述 JSON 配置添加到你的 MCP 客户端配置文件中，并确保替换 'KIBELA_TEAM' 和 'KIBELA_TOKEN' 为你自己的 Kibela 凭据。
在 LLM 中使用工具: 在支持 MCP 协议的 LLM 应用中，你可以调用以下工具来与 Kibela 交互：
- 'kibela_search_notes': 用于搜索 Kibela 笔记。
- 'kibela_get_my_notes': 用于获取最新的 Kibela 笔记。
- 'kibela_get_note_content': 用于获取指定 Kibela 笔记的内容。
具体工具的使用方法和参数，请参考仓库 'README.md' 文件中 "Tools" 部分的详细描述。

关键词