Bunnyshell
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
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BunnyshellCommand (node, npx, python, etc.)nodeArguments-
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.
-
Argument 1
- 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:
bashgit clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
2. Run the setup script:
bash./setup.sh
1. Clone the repository:
bashgit 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:
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





