Bunnyshell MCP Server

Bunnyshell MCP Server

site icon
2025.03.20 0
TypeScript开发工具自动化管理开发效率
Bunnyshell MCP Server 是一个实现 Model Context Protocol (MCP) 的服务,用于通过 Bunnyshell CLI (`bns`) 与 Bunnyshell 平台进行交互。该服务允许 AI 助手(如 Claude)通过自然语言命令管理 Bunnyshell 资源。
View on GitHub

Overview

基本能力

产品定位

Bunnyshell MCP Server 是一个中间件服务,旨在通过自然语言命令简化与 Bunnyshell 平台的交互,提高开发和管理效率。

核心功能

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

适用场景

  • 通过自然语言命令管理 Bunnyshell 资源
  • 自动化 Bunnyshell 平台的操作流程
  • 提高开发和管理效率

工具列表

  • Bunnyshell CLI (bns):用于与 Bunnyshell 平台交互的命令行工具
  • Claude Desktop:AI 助手,用于通过自然语言命令与 MCP 服务器交互
  • Docker 和 Docker Compose:用于 Docker 环境下的部署和运行

常见问题解答

  • API 令牌安全:API 令牌不会存储在代码或配置文件中,可以通过命令行选项、环境变量或会话存储提供。
  • 命令日志:命令日志会省略敏感信息。

使用教程

使用依赖

  • Node.js 18+ 和 npm
  • Bunnyshell CLI (bns) 安装并配置
  • Claude Desktop
  • Docker 和 Docker Compose(用于 Docker 设置)

安装教程

本地设置

  1. 克隆仓库:
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
  1. 运行设置脚本:
./setup.sh

Docker 设置

  1. 克隆仓库:
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
  1. 运行 Docker 设置脚本:
./docker-setup.sh

调试方式

  1. 启动或重启 Claude Desktop
  2. 与 Claude 开始新对话
  3. 点击 '+' 添加附件并选择 'Connect to MCP server'
  4. 从服务器列表中选择 'bunnyshell-mcp'
  5. 设置 Bunnyshell API 令牌:
token: YOUR_API_TOKEN

示例命令

  • "List my organizations"
  • "Create a new project called 'MyProject' in organization ABC123"
  • "List all environments in project XYZ789"
  • "Start environment ENV123"
  • "Deploy component COMP456"
  • "Create a variable called 'DATABASE_URL' in environment ENV123"

构建和测试

  • 构建:
npm install
npm run build
  • 运行测试:
npm test

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。