🚀 兔子壳 MCP 服务器
兔子壳 MCP 服务器是一个基于 Model Context Protocol (MCP) 的实现，借助其 CLI 接口，能让 AI 助手（如 Claude）通过自然语言命令与 Bunnyshell 平台实现交互，为管理和操作 Bunnyshell 资源提供了一组实用工具。
🚀 快速开始
该项目创建的 MCP 服务器，可让 AI 助手（如 Claude）通过自然语言命令与 Bunnyshell 平台交互，为管理和操作 Bunnyshell 资源提供了便利。
✨ 主要特性
- 组织管理：列出和导航组织
- 项目管理：创建、列出和删除项目
- 环境管理：创建、列出、启动、停止和删除环境
- 组件操作：部署、调试和 SSH 进入组件
- 变量与密钥管理：管理环境变量和密钥
- 远程开发：启动远程开发会话并设置端口转发
📦 安装指南
本地设置
- 克隆仓库：
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
- 运行设置脚本：
./setup.sh
Docker 设置
- 克隆仓库：
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
- 运行 Docker 设置脚本：
./docker-setup.sh
💻 使用示例
基础用法
- 启动或重启 Claude Desktop
- 开启新的对话与 Claude 交流
- 点击 '+' 添加附件，并选择 '连接到 MCP 服务器'
- 从服务器列表中选择 'bunnyshell-mcp'
- 设置您的 Bunnyshell API 令牌：
token: 您的_API_令牌
高级用法
您可以要求 Claude 执行以下操作：
- "列出我的组织"
- "在组织 ABC123 中创建名为 'MyProject' 的新项目"
- "列出项目 XYZ789 中的所有环境"
- "启动环境 ENV123"
- "部署组件 COMP456"
- "在环境 ENV123 中创建变量 'DATABASE_URL'"
📚 详细文档
项目结构
.
├── src/
│ ├── tools.ts # 工具实现
│ ├── utils.ts # 辅助函数
│ └── index.ts # 服务器入口点
├── .cursor/
│ └── mcp.json # Cursor MCP 配置文件
├── setup.sh # 本地设置脚本
├── docker-setup.sh # Docker 设置脚本
└── README.md # 说明文档
使用游标 MCP
{
"version": "1.0",
"mcpServers": {
"bunnyshell-mcp": {
"url": "http://localhost:3000"
}
}
}
先决条件
- Node.js 18+ 和 npm
- 已安装并配置好的 Bunnyshell CLI（
bns） - Claude Desktop
- Docker 及 Docker Compose（用于 Docker 设置）
📄 许可证
项目使用 MIT License。
🔗 联系方式
如需反馈或问题，请联系 project maintainers。
贡献指南
如需贡献，请参考项目仓库中的 CONTRIBUTING.md。