Bunnyshell

by aminalali8

Not rated
GitHub

About

Enables direct management of Bunnyshell cloud environments through natural language commands, supporting environment creation, component deployment, and remote development workflows via CLI capabilities.

Details

Author
aminalali8
Repository
aminalali8/bns-mcp-server
License
MIT License
Categories
Productivity, Developer Tools, Design, Workplace, AI, Security, Communication
Tags
#integration

- Organization Management: List and navigate organizations
- Project Management: Create, list, and delete projects
- Environment Management: Create, list, start, stop, and delete environments
- Component Operations: Deploy, debug, and SSH into components
- Variable & Secret Management: Manage environment variables and secrets
- Remote Development: Start remote development sessions and set up port forwarding

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Bunnyshell
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 dist/index.js
    Environment
    • BNS_API_KEY YOUR_API_TOKEN_HERE

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Start or restart Claude Desktop
2. Start a new conversation with Claude
3. Click '+' to add an attachment and select 'Connect to MCP server'
4. Choose 'bunnyshell-mcp' from the list of servers
5. Set your Bunnyshell API token:


1. Clone the repository:
bash
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp

2. Run the setup script:
bash
./setup.sh

1. Clone the repository:
bash
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp

2. Run the Docker setup script:
bash
./docker-setup.sh
```

List my organizations

Retrieves and displays a list of organizations associated with the user.

Create a new project

Creates a new project with a specified name in a given organization. Parameters: project_name (string), organization_id (string)

List all environments

Lists all environments within a specified project. Parameters: project_id (string)

Start environment

Starts a specified environment. Parameters: environment_id (string)

Deploy component

Deploys a specified component. Parameters: component_id (string)

Create a variable

Creates a new environment variable with a specified name in a given environment. Parameters: variable_name (string), environment_id (string)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bunnyshell": {
            "env": {
                "BNS_API_KEY": "YOUR_API_TOKEN_HERE"
            },
            "args": [
                "dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "BNS_API_KEY": "YOUR_API_TOKEN_HERE"
    },
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "BNS_API_KEY": "YOUR_API_TOKEN_HERE"
    },
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "BNS_API_KEY": "YOUR_API_TOKEN_HERE"
    },
    "args": [
        "dist/index.js"
    ],
    "command": "node"
}

Bunnyshell MCP Server

A Model Context Protocol (MCP) server implementation for interfacing with the Bunnyshell platform through its CLI.

Overview

This project creates an MCP server that enables AI assistants (like Claude) to interact with the Bunnyshell platform using the Bunnyshell CLI (bns). The server provides a set of tools for managing your Bunnyshell resources through natural language commands.

Features

- Organization Management: List and navigate organizations
- Project Management: Create, list, and delete projects
- Environment Management: Create, list, start, stop, and delete environments
- Component Operations: Deploy, debug, and SSH into components
- Variable & Secret Management: Manage environment variables and secrets
- Remote Development: Start remote development sessions and set up port forwarding

Prerequisites

- Node.js 18+ and npm
- Bunnyshell CLI (bns) installed and configured
- Claude Desktop
- Docker and Docker Compose (for Docker setup)

Installation

Local Setup

1. Clone the repository:

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

2. Run the setup script:

./setup.sh

Docker Setup

1. Clone the repository:

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

2. Run the Docker setup script:

./docker-setup.sh

Usage

1. Start or restart Claude Desktop
2. Start a new conversation with Claude
3. Click '+' to add an attachment and select 'Connect to MCP server'
4. Choose 'bunnyshell-mcp' from the list of servers
5. Set your Bunnyshell API token:
```

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.