Bns MCP Server

🚀 兔子壳 MCP 服务器

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

🚀 快速开始

该项目创建的 MCP 服务器，可让 AI 助手（如 Claude）通过自然语言命令与 Bunnyshell 平台交互，为管理和操作 Bunnyshell 资源提供了便利。

✨ 主要特性

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

📦 安装指南

本地设置

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

💻 使用示例

基础用法

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"
    }
  }
}

先决条件

• Node.js 18+ 和 npm
• 已安装并配置好的 Bunnyshell CLI（bns）
• Claude Desktop
• Docker 及 Docker Compose（用于 Docker 设置）

📄 许可证

项目使用 MIT License。

🔗 联系方式

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

贡献指南

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