克劳德码蜂窝MCP服务器
查询、探索和分析您的 蜂窝 可观察性数据直接来自Claude Code。
特性
- 自然语言查询 --询问有关您的服务的问题并获取Honeycomb查询结果
- 模式探索 --发现环境、数据集、列、SLO、板和触发器
- 事件分析 --使用指导性根本原因分析模式调查问题
- 安全凭据 -管理API密钥存储在macOS密钥链中,从不在配置文件或Claude日志中
快速开始```bash
git clone git@github.com:kosli-dev/honeycomb-plugin.git
cd honeycomb-plugin
pnpm install
pnpm build
./setup.sh
安装脚本将:
1. 提示输入您的Honeycomb Management API密钥机密和密钥ID(存储在macOS密钥链中-机密输入被隐藏)
1. 提示您的团队段塞和API基本URL(存储在 `~/.config/kosli-honeycomb/config.json`)
1. 可选择将MCP服务器条目添加到Claude Code配置文件中
您可以:
- 提供MCP配置文件的路径(例如。 `~/.claude.json`)脚本将自动添加条目
- 手动添加条目——脚本将显示要复制的JSON
然后重新启动Claude Code以获取新的MCP服务器。
## 先决条件
你需要一个蜂巢 **管理API密钥** 使用这些范围:
- `api-keys:read` --列出现有密钥
- `api-keys:write` --创建/删除临时查询键
- `environments:read` --列出环境
在Honeycomb中创建一个→ 团队设置→ API密钥→ 创建管理密钥。
## 凭据管理
### 如何存储凭据
- **管理密钥** → macOS钥匙扣(`security` CLI,服务: `kosli-honeycomb`)
- **团队子弹/API基地** → `~/.config/kosli-honeycomb/config.json`
- **没什么敏感的** 存储在任何配置文件、环境变量或Claude Code设置中
### 运行时凭据如何流动
1. MCP服务器作为Claude Code的子进程启动
1. 服务器从Keychain内部读取管理密钥(通过 `security find-generic-password`)
1. 服务器为每个Honeycomb环境创建短暂的临时配置密钥
1. 临时密钥在服务器内存中缓存30分钟,然后旋转
1. 服务器关闭时,所有临时密钥都会被删除
1. **任何关键材料都不会越过MCP协议边界** --Claude只看到查询结果
### 纵深防御
- 在返回Claude之前,所有错误消息都经过净化,以去除按键模式
- 已注册的密钥(管理密钥+所有临时密钥)被替换为 `[REDACTED]`
- 已知的蜂窝钥匙图案(`hcx*k_*`、承载令牌、十六进制密钥ID)被剥离
- 如果用户不小心将凭据粘贴到聊天中,技能会警告用户
### 检查/更新/删除凭据```bash
# Check if credentials are configured
security find-generic-password -s "kosli-honeycomb" -a "management-key"
# Update credentials
./setup.sh
# Remove everything
./setup.sh --uninstall
技能
/honeycomb:explore
探索您的蜂窝设置——环境、数据集、模式、SLO。```
/honeycomb:explore What datasets do we have in production?
### `/honeycomb:query`
对Honeycomb数据集运行查询。```
/honeycomb:query What's the P99 latency for the checkout service in production over the last hour?
/honeycomb:analyze
深度分析——事件调查、趋势比较、top-N分析。```
/honeycomb:analyze We're seeing elevated error rates in production. What's going on?
## 发展```bash
pnpm install
pnpm build # compile TypeScript
pnpm dev # watch mode
正在更新```bash
cd honeycomb-plugin
git pull
pnpm install
pnpm build
Restart Claude Code
```
许可证
麻省理工学院
