🚀 兔子壳 MCP 服务器

兔子壳 MCP 服务器是一个基于 Model Context Protocol (MCP) 的实现，借助其 CLI 接口，可让 AI 助手（如 Claude）通过自然语言命令与 Bunnyshell 平台进行交互，为管理和操作 Bunnyshell 资源提供了便捷的工具。

🚀 快速开始

该项目创建的 MCP 服务器，能让 AI 助手（像 Claude）通过自然语言命令与 Bunnyshell 平台交互。服务器提供了一系列工具，用于管理和操作您的 Bunnyshell 资源。

✨ 主要特性

• 组织管理：可列出和导航组织。
• 项目管理：支持创建、列出和删除项目。
• 环境管理：能够创建、列出、启动、停止和删除环境。
• 组件操作：可部署、调试和 SSH 进入组件。
• 变量与密钥管理：方便管理环境变量和密钥。
• 远程开发：能启动远程开发会话并设置端口转发。

📦 安装指南

先决条件

• 需要安装 Node.js 18+ 和 npm。
• 已安装并配置好的 Bunnyshell CLI（bns）。
• 需安装 Claude Desktop。
• 若进行 Docker 设置，要安装 Docker 及 Docker Compose。

本地设置

1. 克隆仓库：

git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp

2. 运行设置脚本：

./setup.sh

Docker 设置

1. 克隆仓库：

git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp

2. 运行 Docker 设置脚本：

./docker-setup.sh

💻 使用示例

基础用法

使用该 MCP 服务器与 Claude 交互的步骤如下：

1. 启动或重启 Claude Desktop。
2. 开启新的对话与 Claude 交流。
3. 点击 '+' 添加附件，并选择 '连接到 MCP 服务器'。
4. 从服务器列表中选择 'bunnyshell-mcp'。
5. 设置您的 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"
    }
  }
}

贡献指南

如需贡献，请参考项目仓库中的 CONTRIBUTING.md。

联系方式

如需反馈或问题，请联系 project maintainers。

📄 许可证

项目使用 MIT License。