Cover image
Try Now
2025-03-20

3 years

Works with Finder

1

Github Watches

1

Github Forks

0

Github Stars

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
  1. Run the setup script:
./setup.sh

Docker Setup

  1. Clone the repository:
git clone https://github.com/bunnyshell/bns-mcp.git
cd bns-mcp
  1. 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:
token: YOUR_API_TOKEN

Example Commands

You can ask Claude to:

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

Development

Project Structure

.
├── src/
│   ├── tools.ts       # Tool implementations
│   ├── utils.ts       # Utility functions
│   └── index.ts       # Server entry point
├── .cursor/
│   └── mcp.json      # Cursor MCP configuration
├── setup.sh          # Local setup script
├── docker-setup.sh   # Docker setup script
└── README.md         # Documentation

Cursor MCP Configuration

The .cursor/mcp.json file contains the configuration for the MCP server in Cursor:

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

For Docker setup, use:

{
  "mcpServers": {
    "bunnyshell-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "bns-mcp-server", "node", "dist/index.js"],
      "env": {
        "BNS_API_KEY": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Note: By adding your Bunnyshell API token to the env section, the MCP server will automatically use it for authentication without requiring you to provide it for each command. The code already checks for the BNS_API_KEY environment variable. This is especially useful for development and personal use. For shared environments, it's recommended to omit the token from configuration files and provide it during the conversation instead.

Building

npm install
npm run build

Running Tests

npm test

Security

  • API tokens are never stored in the code or configuration files
  • Tokens can be provided via:
    • Command line options
    • Environment variable (BNS_API_KEY)
    • Session storage (temporary, in-memory only)
  • Command logging omits sensitive information

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

MIT License

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Callycode Limited
  • A geek-themed horoscope generator blending Bitcoin prices, tech jargon, and astrological whimsy.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Khalid kalib
  • Write professional emails

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • Beniyam Berhanu
  • Therapist adept at identifying core issues and offering practical advice with images.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • apappascs
  • Entdecken Sie die umfassendste und aktuellste Sammlung von MCP-Servern auf dem Markt. Dieses Repository dient als zentraler Hub und bietet einen umfangreichen Katalog von Open-Source- und Proprietary MCP-Servern mit Funktionen, Dokumentationslinks und Mitwirkenden.

  • OffchainLabs
  • GO -Umsetzung des Ethereum -Beweises des Anteils

  • huahuayu
  • Ein einheitliches API-Gateway zur Integration mehrerer Ethercan-ähnlicher Blockchain-Explorer-APIs mit Modellkontextprotokoll (MCP) für AI-Assistenten.

  • deemkeen
  • Steuern Sie Ihren MBOT2 mit einer Power Combo: MQTT+MCP+LLM

    Reviews

    4 (1)
    Avatar
    user_mj2sgPs8
    2025-04-15

    Azure Revisor MCP Server has revolutionized my workflow with its seamless integration and robust performance. Mikhael Abdallah has developed an outstanding product that ensures reliability and efficiency in server management. The intuitive interface and comprehensive feature set make it a must-have for any IT professional. Highly recommend!