内容
# Kimi MCP Hub
一键式 MCP 服务器和技能管理器，适用于 **Kimi CLI** —— 类似于 `claude-mem`，但可连接 23 个 MCP 服务器（Jira、GitHub、Slack、Datadog、Perplexity、Stripe、GitLab、DBHub 等）、56 种 AI 技能（6 种核心技能 + 50 种可选技能）、持久内存和 Claude Desktop 导入。
---
## 目录
- [安装](#安装)
- [一键安装（无需克隆）](#一键安装无需克隆)
- [从 GitHub 安装（pip）](#从-github-安装pip)
- [克隆 + 安装](#克隆--安装)
- [验证](#验证)
- [卸载](#卸载)
- [快速入门](#快速入门)
- [管理 MCP 服务器和技能](#管理-mcp-服务器和技能)
- [项目级 MCP 配置](#项目级-mcp-配置)
- [远程 MCP 服务器设置](docs/remote-mcp-server-setup.md)
- [OAuth 自动浏览器](#oauth-自动浏览器)
- [所有命令](#所有命令)
- [MCP 服务器](#23-个-mcp-服务器)
- [技能](#56-种技能)
- [架构](#架构)
---
## 安装
### 使用 npx 的一键安装（推荐）
```bash
# macOS / Linux / Windows
npx kimi-mcp-hub install
```
这会在 `~/.kimi-mcp-hub/venv` 中创建一个隔离的 Python 虚拟环境，安装软件包，并运行交互式设置向导。
### 使用 curl / PowerShell 的一键安装
```bash
# macOS / Linux（curl + pip from GitHub）
curl -fsSL https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.sh | bash
# Windows（PowerShell）
iwr -useb https://raw.githubusercontent.com/KalimeroMK/kimi-mcp-hub/main/install/install.ps1 | iex
```
### 从 GitHub 安装（pip）
```bash
# 直接从 GitHub 安装，无需克隆
pip install --user git+https://github.com/KalimeroMK/kimi-mcp-hub.git
# 升级
pip install --user --upgrade git+https://github.com/KalimeroMK/kimi-mcp-hub.git
```
### 从 PyPI 安装（发布后可用）
```bash
pip install --user kimi-mcp-hub
```
### 克隆 + 安装（开发）
```bash
git clone https://github.com/KalimeroMK/kimi-mcp-hub.git
cd kimi-mcp-hub
pip install -e .
```
### 要求
- **Python** 3.10+
- **Node.js** + **npm/npx**（某些 MCP 服务器需要）
- 已安装 **Kimi CLI**
- 可选：**Docker**（某些服务器需要）
### 验证
```bash
kimi-mcp-hub --version
# -> kimi-mcp-hub, version 0.1.0
```
首次运行时，您将看到：
```
Kimi MCP Hub v0.1.0 安装成功！
23 个 MCP 服务器可用
56 种 AI 技能，助力更好编码
1 持久内存系统
开始使用：
kimi-mcp-hub init -- 交互式向导
kimi-mcp-hub welcome -- 详细概述
kimi-mcp-hub status -- 状态检查
kimi-mcp-hub doctor -- 系统健康检查
```
### 运行向导
```bash
kimi-mcp-hub init
```
这将引导您完成：
1. **MCP 服务器** -- 如果有 `npx`，则自动安装 Chrome DevTools、Context7 和 Playwright；手动选择其他服务
2. **技能** -- 安装 AI 行为模式
3. **内存** -- 启用持久跨会话内存
---
## 卸载
```bash
# 完全重置
pip uninstall kimi-mcp-hub
rm -f ~/.kimi-code/mcp.json
rm -rf ~/.kimi-code/skills/
rm -rf ~/.kimi-mcp-hub/
rm -rf ~/.config/kimi-mcp-hub/
# 或使用 CLI
kimi-mcp-hub remove jira # 删除一个服务器
kimi-mcp-hub remove github # 删除另一个服务器
```
**完整重新安装：**
```bash
pip uninstall kimi-mcp-hub
rm -rf ~/.kimi-code/mcp.json ~/.kimi-code/skills/ ~/.kimi-mcp-hub/
pip install --user git+https://github.com/KalimeroMK/kimi-mcp-hub.git
kimi-mcp-hub init
```
---
## 快速入门
```bash
# 显示欢迎横幅 + 状态
kimi-mcp-hub
# 检查系统健康状况
kimi-mcp-hub doctor
# 完整交互式设置
kimi-mcp-hub init
# 单独添加服务器
kimi-mcp-hub add jira
kimi-mcp-hub add github
kimi-mcp-hub add slack
kimi-mcp-hub add supabase
kimi-mcp-hub add perplexity
kimi-mcp-hub add gitlab
kimi-mcp-hub add stripe
kimi-mcp-hub add figma-context
kimi-mcp-hub add desktop-commander
kimi-mcp-hub add dbhub
kimi-mcp-hub add mobile
# 或在不全局安装 Node 包的情况下使用 npx：
# npx kimi-mcp-hub status
# 使用自动浏览器（OAuth）认证 -- 类似 Claude Code CLI
kimi-mcp-hub auth github
kimi-mcp-hub auth figma
kimi-mcp-hub auth gitlab
kimi-mcp-hub auth stripe
# 对于官方远程 MCP 服务器，Kimi CLI 处理弹出窗口：
# /mcp-config login jira
# /mcp-config login linear
# /mcp-config login confluence
# /mcp-config login supabase
# 查看已配置的所有内容
kimi-mcp-hub list
kimi-mcp-hub status
kimi-mcp-hub welcome
kimi-mcp-hub notify
# 修复软件包更新后的损坏配置
kimi-mcp-hub repair
# 项目级 MCP 配置
kimi-mcp-hub add --project linear # 保存到 ./.kimi/mcp.json
kimi-mcp-hub sync # 合并项目配置到全局配置
# 从 Claude Desktop 导入
kimi-mcp-hub import-claude
# 管理技能
kimi-mcp-hub list-skills
kimi-mcp-hub install-skill docker-pro
# 测试服务器
kimi-mcp-hub test github
```
---
## 管理 MCP 服务器和技能
### 技能
在 **Kimi CLI** 中切换技能：
```text
/skill:caveman
/skill:headroom
/skill:code-review
```
- 核心技能（`karpathy`、`superpowers`、`caveman`、`headroom`、`context-mode`、`cybersecurity`）在每次启动 Kimi 时自动激活。
- 从终端安装更多技能：
```bash
kimi-mcp-hub install-skill docker-pro
```
### MCP 服务器
在 **Kimi CLI** 之外启用 MCP 服务器，在您的普通终端中：
```bash
# 标准输入 / API 密钥服务器
kimi-mcp-hub add linear
kimi-mcp-hub add github
kimi-mcp-hub add slack
# 官方远程 OAuth 服务器也可以在 Kimi 内连接：
# /mcp-config login linear
# /mcp-config login jira
# /mcp-config login supabase
```
当您第一次添加基于 `npx` 的服务器时，`kimi-mcp-hub` 会检查该软件包是否已安装，并提示您全局安装它。这可以防止 Kimi CLI 尝试启动尚未缓存的 `npx` 软件包时出现的 30 秒超时。
添加服务器后，**重启 Kimi CLI** （`exit` → `kimi`），使其获取新的配置。
有关官方远程 OAuth 服务器（Linear、Jira、Confluence、Supabase、Figma、Stripe、GitLab）的详细演练，请参阅 [远程 MCP 服务器设置](docs/remote-mcp-server-setup.md)。
---
## 项目级 MCP 配置
如果您在多个项目中使用不同的 MCP 账户（例如，每个客户端使用不同的 Linear 团队/API 密钥），可以在每个项目中存储 MCP 服务器：
```bash
cd my-project
kimi-mcp-hub add --project linear
kimi-mcp-hub sync
```
这会创建：
```text
my-project/
└── .kimi/
├── mcp.json # 服务器配置，带有 ${VAR} 占位符
└── mcp.env # 机密值（添加到 .gitignore）
```
`.kimi/mcp.env` 示例：
```bash
LINEAR_API_KEY=lin_api_your_project_key
```
`.kimi/mcp.json` 示例：
```json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@emmett.deen/linear-mcp-server"],
"env": {
"LINEAR_API_KEY": "${LINEAR_API_KEY}"
}
}
}
}
```
### 在项目之间切换
当您切换项目时，运行 `sync` 以用该项目的服务器重写全局 `~/.kimi-code/mcp.json`：
```bash
cd project-a && kimi-mcp-hub sync # 全局配置现在使用 project-a 的 Linear
cd project-b && kimi-mcp-hub sync # 全局配置现在使用 project-b 的 Linear
```
项目服务器覆盖具有相同名称的全局服务器。未被覆盖的全局服务器仍然可用。
### 带有 --project 的命令
```bash
kimi-mcp-hub init --project # 将向导服务器保存到当前项目
kimi-mcp-hub add --project linear # 将服务器添加到当前项目
kimi-mcp-hub auth --project github # 授权并保存到当前项目
kimi-mcp-hub remove --project linear # 从当前项目中删除服务器
kimi-mcp-hub sync # 将当前项目合并到全局配置中
kimi-mcp-hub sync /path/to/project # 合并特定项目
```
如果您已安装 **Desktop Commander**，也可以要求 Kimi 为您运行命令：
```text
run kimi-mcp-hub add linear in the terminal
```
---
## OAuth 自动浏览器
与 Claude Code CLI 类似，`kimi-mcp-hub` 会自动为您打开浏览器进行 OAuth：
```bash
$ kimi-mcp-hub auth github
> Github 授权
自动浏览器模式（类似 Claude Code CLI）
方法：设备流 -- 自动浏览器 + 代码
您的验证码：ABCD-1234
打开浏览器...
如果浏览器未打开：
1. 前往：https://github.com/login/device
2. 输入代码：ABCD-1234
3. 点击“授权”
等待您在浏览器中授权...
GitHub 授权成功！
```
| 服务器 | 方法 | 自动浏览器 |
|--------|------|:-----:|
| **GitHub** | 设备流（或 PAT 备用） | 是 |
| **Jira** | 官方 MCP OAuth 或 API 令牌 | 是* |
| **Confluence** | 官方 MCP OAuth 或 API 令牌 | 是* |
| **Slack** | 机器人/用户令牌（`slack-mcp-server`） | 否（手动令牌） |
| **Figma** | 官方 OAuth 2.1、PAT 或自定义 OAuth 2.0 | 是* |
| **Gmail** | Google OAuth 2.0 或 npx | 是 |
| **Linear** | 官方 OAuth 2.1 或 API 密钥 | 是* |
| **Stripe** | 官方 OAuth 2.1 或受限 API 密钥 | 是* |
| **GitLab** | 官方 OAuth 2.1 或 PAT | 是* |
| **Supabase** | 官方远程 OAuth 或访问令牌 stdio | 是* |
| **Datadog** | API + 应用程序密钥 | 否（手动） |
\* 官方远程 OAuth 2.1 由 Kimi CLI 启动（`kimi mcp auth <server>` 或 `/mcp-config login <server>`），在您添加官方远程 MCP 服务器后。
---
## 所有命令
| 命令 | 描述 |
|---------|-------------|
| `kimi-mcp-hub` | 显示欢迎横幅和状态 |
| `kimi-mcp-hub --version` | 显示版本 |
| `kimi-mcp-hub install` | 从 PyPI/GitHub 安装/更新 |
| `kimi-mcp-hub init` | 完整交互式向导 |
| `kimi-mcp-hub status` | 版本、服务器、技能、内存 |
| `kimi-mcp-hub welcome` | 详细欢迎横幅 |
| `kimi-mcp-hub notify` | Shell 包装器的简短启动通知 |
| `kimi-mcp-hub add <server>` | 添加 MCP 服务器 |
| `kimi-mcp-hub add --project <server>` | 将 MCP 服务器添加到当前项目 |
| `kimi-mcp-hub remove <server>` | 删除 MCP 服务器 |
| `kimi-mcp-hub remove --project <server>` | 从当前项目中删除 MCP 服务器 |
| `kimi-mcp-hub auth <server>` | OAuth 带有自动浏览器 |
| `kimi-mcp-hub auth --project <server>` | OAuth 并保存到当前项目 |
| `kimi-mcp-hub sync` | 将项目 `.kimi/mcp.json` 合并到全局配置中 |
| `kimi-mcp-hub repair` | 修复损坏/过时的服务器配置 |
| `kimi-mcp-hub import-claude` | 从 Claude Desktop 导入 |
| `kimi-mcp-hub list` | 所有服务器 + 技能 + 内存 |
| `kimi-mcp-hub list-skills` | 所有 56 种可用技能 |
| `kimi-mcp-hub install-skill <name>` | 安装技能 |
| `kimi-mcp-hub test <server>` | 测试服务器是否响应 |
| `kimi-mcp-hub doctor` | 系统健康检查 |
---
## 23 个 MCP 服务器
| 服务器 | 认证 | 工具 | 最佳用途 |
|--------|------|:-----:|----------|
| **Jira** | OAuth（云）或 API 令牌 | 8 | 工单、冲刺、工作日志 |
| **Linear** | 官方 OAuth 2.1 或 API 密钥 | 6 | 问题、项目、团队 |
| **Confluence** | OAuth 或 API 令牌 | 5 | 文档、wiki、页面 |
| **GitHub** | 设备流 / PAT | 6 | 仓库、PR、问题、代码 |
| **Slack** | 机器人/用户令牌（`slack-mcp-server`） | 7 | 频道、直接消息、搜索 |
| **Datadog** | 官方远程 MCP（API + 应用程序密钥） | 12 | 指标、日志、监视器、APM |
| **Figma** | 官方 OAuth 2.1、PAT 或自定义 OAuth | 9 | 设计、令牌、组件 |
| **Figma Context** | Figma API 访问令牌 | 3 | 设计到代码实现 |
| **GitLab** | 官方 OAuth 2.1 或 PAT | 8 | 仓库、合并请求、问题、CI/CD 管道 |
| **Gmail** | OAuth（npx）、Chrome 桥接器或 Python SDK | 8 | 读取、搜索、发送电子邮件 |
| **HubSpot** | 私有应用令牌 | 9 | CRM 联系人、交易、公司 |
| **Stripe** | 官方 OAuth 2.1 或受限 API 密钥 | 8 | 支付、客户、订阅、发票 |
| **Desktop Commander** | STDIO（npx/Docker） | 8 | 终端命令、文件操作、进程管理 |
| **DBHub** | DSN 字符串（可选读取） | 2 | 多数据库网关（PG、MySQL、SQLite 等） |
| **Mobile MCP** | STDIO（npx） | 9 | 模拟器和真机上的 iOS/Android 自动化 |
| **Grain** | 浏览器自动化 | 2 | 会议记录 |
| **Chrome DevTools** | STDIO（Node 22+ 需要） | 10 | 性能、网络、截图、控制台 |
| **PostgreSQL** | DSN 字符串 | 6 | SQL 查询、模式、慢查询分析 |
| **Playwright** | STDIO（Node.js） | 8 | 浏览器自动化、端到端测试、截图 |
| **Sentry** | 认证令牌 + 组织 | 6 | 错误跟踪、问题分类、堆栈跟踪 |
| **Context7** | STDIO（npx） | 4 | 实时库文档、版本感知 API 查找 |
| **Supabase** | 官方远程 OAuth 或访问令牌 stdio | 6 | 数据库、认证、存储、实时、边缘函数 |
| **Perplexity** | **API 密钥（付费，5 美元试用积分）** | **3** | **带有 AI 摘要和引用的实时网络搜索** |
---
## 56 种技能
### 核心技能（默认安装）
| 技能 | 描述 |
|-------|-------------|
| **karpathy** | 清洁、简单、可读的代码规范 |
| **superpowers** | 14 种代理工作流（计划、调试、测试、部署...） |
| **headroom** | 压缩大型工具输出以节省令牌 |
| **context-mode** | 上下文窗口优化和令牌预算 |
| **cybersecurity** | 网络安全专家（OWASP、云、IR、渗透测试） |
| **caveman** | 超压缩的洞穴人通信模式 |
### 前端技能（默认作为一个堆栈安装）
| 技能 | 描述 |
|-------|-------------|
| **react-coder** | React 19 专家（RSC、钩子） |
| **ts-coder** | TypeScript 专家（严格、泛型） |
| **ui-engineer** | UI 组件实现（Tailwind、a11y） |
| **ui-ux-pro-max** | UI/UX 设计智能和设计系统 |
| **vercel-react-best-practices** | React/Next.js 性能优化 |
| **web-design-guidelines** | 根据 Vercel 指南审核 UI 代码 |
| **agent-browser** | 用于网页任务和测试的浏览器自动化 |
| **design-system** | 设计令牌、组件规范和系统化设计系统 |
### 代码质量和审查技能
| 技能 | 描述 |
|-------|-------------|
| **code-reviewer** | 快速的单一代理代码审查 |
| **code-review** | 多代理代码审查（探索/编码/计划） |
| **surgical-refactoring** | 无行为变化的外科代码重构 |
| **tdd** | 带有红绿重构的测试驱动开发 |
| **perf-optimization** | 性能分析 和 优化 |
| **security-audit** | 安全审查检查清单 |
| **security-guidance** | 3 层安全扫描指导 |
### 架构和设计技能
| 技能 | 描述 |
|-------|-------------|
| **api-designer** | REST/GraphQL API 设计 |
| **backend-architect** | 后端架构和系统设计 |
| **backend-typescript-architect** | TypeScript/Bun 后端架构 |
| **codebase-design** | 设计深层模块和可测试的接口 |
| **domain-modeling** | 构建领域模型和通用语言 |
| **database-expert** | 数据库设计和优化 |
| **api-design** | REST API 设计模式 |
### DevOps 和部署技能
| 技能 | 描述 |
|-------|-------------|
| **docker-pro** | Docker 和 Kubernetes 最佳实践 |
| **gitnexus** | 代码知识图和爆炸半径 |
| **resolving-merge-conflicts** | 解决 git 合并/变基冲突 |
| **deployment-patterns** | CI/CD 和部署最佳实践 |
### 语言/框架技能
| 技能 | 描述 |
|-------|-------------|
| **python-engineer** | Python 专家（FastAPI、Django、async） |
| **laravel-engineer** | Laravel 专家（Eloquent、Blade、Livewire） |
| **php-pro** | 高级 PHP 开发（严格类型、Laravel/Symfony、PSR） |
| **wp-plugin-development** | 带有钩子和设置 API 的 WordPress 插件开发 |
| **react-coder** | React 19 专家（RSC、钩子） |
| **ts-coder** | TypeScript 专家（严格、泛型） |
| **ui-engineer** | UI 组件实现（Tailwind、a11y） |
| **ui-ux-pro-max** | UI/UX 设计智能和设计系统 |
### 数据和迁移技能
| 技能 | 描述 |
|-------|-------------|
| **database-migrations** | 安全的数据库迁移模式 |
### 测试和浏览器技能
| 技能 | 描述 |
|-------|-------------|
| **playwright-best-practices** | Playwright 测试最佳实践 |
| **chrome-devtools-skill** | Chrome DevTools MCP 调试和自动化 |
### 研究和自动化技能
| 技能 | 描述 |
|-------|-------------|
| **search-first** | 先研究后编码的工作流程 |
| **regex-vs-llm-structured-text** | 正则表达式与 LLM 解析决策框架 |
### 生产力和元技能
| 技能 | 描述 |
|-------|-------------|
| **caveman-review** | 超压缩的代码审查评论 |
| **caveman-commit** | 超压缩的 Conventional Commits 消息 |
| **memory-palace** | 高级内存和上下文检索 |
| **hindsight** | 从过去的决定中学习的记忆 |
| **task-master** | 任务管理系统 |
| **ralph** | 带有停止钩子的自主循环 |
| **grill-me** | 测试计划或设计 |
| **visual-explainer** | HTML 图表和幻灯片 |
| **research-mode** | 研究驱动的开发 |
| **ecc** | 工程能力（性能、安全、研究） |
| **skill-creator** | 创建和优化代理技能 |
| **agent-automation-recommender** | 为代码库推荐代理自动化 |
| **find-skills** | 发现和安装代理技能 |
### 集成技能
| 技能 | 描述 |
|-------|-------------|
| **stripe-best-practices** | Stripe 集成最佳实践 |
---
## 架构
```
+-----------------------------------------+
| kimi-mcp-hub CLI |
| +---------------------------------+ |
| | （无参数）-> 欢迎横幅 | |
| | install -> PyPI/GitHub 更新 | |
| | init -> 交互式向导 | |
| | add -> 编写 ~/.kimi-code/...| |
| | add --project -> 编写 ./.kimi| |
| | sync -> 合并项目 + 全局 | |
| | auth -> OAuth + 自动浏览器 | |
| | repair -> 修复损坏的配置 | |
| | import-claude -> 迁移配置| |
| | list -> 工具的漂亮表格 | |
| | status -> 版本 + 健康 | |
| | welcome -> 完整信息显示 | |
| | notify -> 启动通知 | |
| +---------------------------------+ |
| | |
| +---------------------------------+ |
| | 全局：~/.kimi-code/mcp.json | |
| | 项目：./.kimi/mcp.json | |
| | 项目机密：./.kimi/mcp.env| |
| | ~/.kimi-code/skills/（56 种技能）| |
| | <config-dir>/kimi-mcp-hub/ | |
| | tokens.json + memory.db | |
| +---------------------------------+ |
| | |
| 可选 shell 包装器打印通知 |
| 在每次 `kimi` 启动时 |
| | |
| Kimi CLI 读取配置 |
| | |
| /mcp 显示工具 |
| 技能自动激活 |
| 内存持久化上下文 |
+-----------------------------------------+
```
---
## 安全说明
- 在 macOS 和 Linux 上，敏感文件（`tokens.json`、`memory.db` 和 `~/.kimi-code/mcp.json`）以 `chmod 600`（仅所有者可读/写）写入。
- 运行 `kimi-mcp-hub doctor` 以检测和修复权限过大的文件。
- OAuth 令牌仍以纯 JSON 存储在这些文件中。这使工具保持无依赖，但允许在 Kimi CLI 活动时具有相同用户权限的进程读取它们。
- 默认情况下，GitHub 身份验证使用公共 OAuth 应用（`kimi-mcp-hub`）。您可以在运行 `kimi-mcp-hub auth <server>` 时提供自己的 GitHub/Atlassian OAuth 客户端 ID。
---
## 许可证
MIT
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器