Bunnyshell MCP Server

What is Bunnyshell MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants (like Claude) to interact with the Bunnyshell platform using its CLI (bns). It provides tools for managing Bunnyshell resources through natural language commands.

How to use Bunnyshell MCP Server?

Clone the repository and run the setup script (./setup.sh or ./docker-setup.sh). Then start or restart Claude Desktop, connect to the MCP server by selecting 'bunnyshell-mcp' from the list, and provide your Bunnyshell API token. Alternatively, set the BNS_API_KEY environment variable in the Cursor configuration file.

Key features of Bunnyshell MCP Server

• Organization Management: list and navigate organizations
• Project Management: create, list, and delete projects
• Environment Management: create, list, start, stop, delete environments
• Component Operations: deploy, debug, and SSH into components
• Variable & Secret Management: manage environment variables and secrets
• Remote Development: start remote sessions and port forwarding

Use cases of Bunnyshell MCP Server

• List your organizations and navigate between them
• Create a new project in a specific organization
• List all environments in a given project
• Start or stop an environment
• Deploy a specific component
• Create a variable (e.g., DATABASE_URL) in an environment

FAQ from Bunnyshell MCP Server

What are the prerequisites?

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

How do I provide my API token?

The token can be provided via command line, the BNS_API_KEY environment variable, or session storage (temporary, in-memory only). In Cursor, you can add it to the env section of mcp.json.

Is there a Docker setup?

Yes. Use the docker-setup.sh script and configure the MCP server with Docker‑specific arguments in the Cursor configuration.

How does the server handle security?

API tokens are never stored in code or configuration files. Commands are logged without sensitive information.

Can I configure the server for Cursor?

Yes. The .cursor/mcp.json file contains configuration for both local (node dist/index.js) and Docker setups, with the BNS_API_KEY environment variable for automatic authentication.