mcpField
M
mcp-kibela 🗒️

mcp-kibela 🗒️

本地服务
github.com/kj455记忆与知识1382 周前更新
代码仓库

关于 mcp-kibela 🗒️

mcp-kibela 是一款 MCP 服务，让 AI 助手搜索和引用 Kibela 中的内容，支持检索及编辑笔记，适用于将 Kibela 用作信息来源的团队。

主要功能

  1. 01按关键词搜索笔记
  2. 02获取最新个人笔记
  3. 03读取笔记内容和评论
  4. 04按路径获取笔记
  5. 05创建笔记
  6. 06更新笔记内容

适用场景

  1. 01按关键词查找 Kibela 笔记
  2. 02查看近期笔记
  3. 03通过 ID 或路径获取笔记
  4. 04创建或更新 Kibela 笔记

MCP 相关

向 MCP 客户端提供 Kibela 笔记搜索、获取、创建和更新能力。访问需要 Kibela 团队名称和 API 令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "<KIBELA_TEAM>",
        "KIBELA_TOKEN": "<KIBELA_TOKEN>"
      }
    }
  }
}
启动命令docker run -i --rm -e KIBELA_TEAM -e KIBELA_TOKEN ghcr.io/kj455/mcp-kibela:latest
需要配置的环境变量
KIBELA_TEAM
KIBELA_TOKEN密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/kj455/mcp-kibela:latest

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-kibela 🗒️

smithery badge npm version License: MIT

一种 Model Context Protocol（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": "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

环境变量

需要设置以下环境变量：

  • KIBELA_TEAM：你的 Kibela 团队名称（必填）。你可以在 Kibela 团队页面的 URL 中找到该名称。例如：https://[team-name].kibe.la
  • KIBELA_TOKEN：你的 Kibela API 令牌（必填）

贡献

欢迎贡献！

开发

  1. 使用 npm run build:watch 以监视模式构建项目。
npm run build:watch
  1. 使用 npx @modelcontextprotocol/inspector 检查 MCP 服务。
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

许可证 📄

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。