kiwamizamurai/mcp-kibela-server
简介
mcp-kibela-server 是一个将 Kibela 数字化名片管理能力集成到 AI 助手中的 MCP 插件。它让 AI 能够直接通过 API 与 Kibela 交互，将原本碎片化的联系人信息转化为 AI 可实时调用的上下文。对于需要频繁管理商务人脉、同步联系人详情的开发者或职场用户，该工具消除了在名片应用与聊天窗口之间来回切换的麻烦，上手难度低，只需配置 API 密钥即可让 AI 具备管理个人社交资产的能力。
核心亮点
- 打通 Kibela API，实现名片数据的实时读写
- 将商务联系人转化为 AI 可感知的上下文
- 无需手动复制，直接通过 AI 指令管理人脉
- 轻量化部署，快速集成至支持 MCP 的客户端
完整文档
Kibela MCP Server
!NPM Downloads   用于 Kibela API 集成的 MCP server 实现，使 LLM 能够与 Kibela 内容进行交互。
<img width="320" alt="Example" src="https://github.com/user-attachments/assets/eeed8f45-eb24-456d-bb70-9e738aa1bfb3" /><a href="https://glama.ai/mcp/servers/m21nkeig1p"><img width="380" height="200" src="https://glama.ai/mcp/servers/m21nkeig1p/badge" alt="Kibela Server MCP server" /></a>
> [!TIP]
> 此扩展使用 graphql 包中的 buildClientSchema、getIntrospectionQuery 和 printSchema 函数进行 GraphQL schema 内省，以反向工程 Kibela 的 API。更多详情请参阅此处
Features
- 使用高级过滤器搜索笔记
- 获取最新笔记
- 获取笔记内容和评论
- 管理组和文件夹
- 点赞/取消点赞笔记
- 列出用户
- 查看笔记附件
- 查看最近浏览的笔记
- 通过路径获取笔记
Configuration### 环境变量
KIBELA_TEAM: 你的 Kibela 团队名称（必填）
KIBELA_TOKEN: 你的 Kibela API token（必填）
Cursor 集成
添加到你的 ~/.cursor/mcp.json：
json
{
"mcpServers": {
"kibela": {
"command": "npx",
"args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
"env": {
"KIBELA_TEAM": "YOUR_TEAM_NAME",
"KIBELA_TOKEN": "YOUR_TOKEN"
}
}
}
}json
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KIBELA_TEAM",
"-e",
"KIBELA_TOKEN",
"ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
],
"env": {
"KIBELA_TEAM": "YOUR_TEAM_NAME",
"KIBELA_TOKEN": "YOUR_TOKEN"
}
}
}
}kibela_search_notes
使用给定查询搜索 Kibela 笔记- Input:
query (string): 搜索查询
- coediting (boolean, optional): 按协同编辑状态过滤
- isArchived (boolean, optional): 按归档状态过滤
- sortBy (string, optional): 排序方式 (RELEVANT, CONTENT_UPDATED_AT)
- userIds (string[], optional): 按用户 ID 过滤
- folderIds (string[], optional): 按文件夹 ID 过滤
- Returns: 匹配的笔记列表，包含 ID、标题、URL、作者、分组等
kibela_get_my_notes
获取你在 Kibela 中的最新笔记- Input:
limit (number, optional): 获取的笔记数量（默认：15）
- Returns: 你的最新笔记列表及作者信息
kibela_get_note_content
获取特定笔记的内容和评论- Input:
id (string): 笔记 ID
- include_image_data (boolean, optional): 响应中是否包含图片数据 URL（默认：false）
- Returns: 完整的笔记内容，包括 HTML、评论、附件、分组、文件夹等
kibela_get_groups
获取可访问的分组列表- Input: None
- Returns: 分组列表，包含隐私设置和权限等详情
kibela_get_group_folders
获取分组中的文件夹- Input:
groupId (string): 分组 ID
- parentFolderId (string, optional): 嵌套文件夹的父文件夹 ID
- Returns: 文件夹列表及其包含的笔记和元数据### kibela_get_group_notes
- 输入：
groupId (string)：组 ID
- 返回：包含作者信息的笔记列表，按最后更新时间排序
kibela_get_folder_notes
获取文件夹中的笔记- 输入：
folderId (string)：文件夹 ID
- limit (number, 可选)：获取的笔记数量（默认：100）
- 返回：包含作者信息的笔记列表，按最后更新时间排序
kibela_get_users
获取用户列表- 输入：无
- 返回：包含 ID、账号和真实姓名的用户列表
kibela_like_note
点赞笔记- 输入：
noteId (string)：笔记 ID
- 返回：更新后的点赞者列表
kibela_unlike_note
取消点赞笔记- 输入：
noteId (string)：笔记 ID
- 返回：更新后的点赞者列表
kibela_get_recently_viewed_notes
获取最近浏览的笔记- 输入：
limit (number, 可选)：获取的笔记数量（最大 15）
- 返回：包含作者信息的最近浏览笔记列表
kibela_get_note_from_path
通过路径或 URL 获取笔记内容- 输入：
path (string)：笔记路径（例如 '/group/folder/note'）或完整的 Kibela URL（例如 'https://team.kibe.la/notes/123'）
- include_image_data (boolean, 可选)：响应中是否包含图片 data URL（默认：false）
- 返回：完整的笔记内容，包括 HTML、评论、附件、组、文件夹等
Local Development
Running from Source
1. 克隆仓库
2. 安装依赖：npm install### 环境搭建
对于本地开发，请更新你的 ~/.cursor/mcp.json：
json
{
"mcpServers": {
"kibela": {
"command": "node",
"args": ["path/to/mcp-kibela-server/dist/src/index.js"],
"env": {
"KIBELA_TEAM": "YOUR_TEAM_NAME",
"KIBELA_TOKEN": "YOUR_TOKEN"
}
}
}
}bash
npx @modelcontextprotocol/inspector node ./dist/src/index.jsDocker
本地构建并运行：
bash
docker build -t mcp-kibela-server .json
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KIBELA_TEAM",
"-e",
"KIBELA_TOKEN",
"mcp-kibela-server"
],
"env": {
"KIBELA_TEAM": "YOUR_TEAM_NAME",
"KIBELA_TOKEN": "YOUR_TOKEN"
}
}
}
}http://localhost:3000/sse
