Bunnyshell MCP Server

Bunnyshell MCP Server

Bunnyshell CLI を通じて Bunnyshell プラットフォームと連携するための、Model Context Protocol（MCP）サーバーの実装です。

概要

このプロジェクトでは、AI アシスタント（Claude など）が Bunnyshell CLI（bns）を使用して Bunnyshell プラットフォームとやり取りできる MCP サーバーを作成します。このサーバーは、自然言語のコマンドを通じて Bunnyshell のリソースを管理するための一連のツールを提供します。

特長

• 組織管理：組織の一覧表示と移動
• プロジェクト管理：プロジェクトの作成、一覧表示、削除
• 環境管理：環境の作成、一覧表示、起動、停止、削除
• コンポーネント操作：コンポーネントのデプロイ、デバッグ、SSH 接続
• 変数とシークレットの管理：環境変数とシークレットの管理
• リモート開発：リモート開発セッションの開始とポートフォワーディングの設定

前提条件

• 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

2. セットアップスクリプトを実行します。

./setup.sh

Docker セットアップ

1. リポジトリをクローンします。

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

2. Docker セットアップスクリプトを実行します。

./docker-setup.sh

使用方法

1. Claude Desktop を起動または再起動します
2. Claude との新しい会話を開始します
3. 「+」をクリックして添付ファイルを追加し、「Connect to MCP server」を選択します
4. サーバーの一覧から「bunnyshell-mcp」を選択します
5. Bunnyshell API トークンを設定します。

token: YOUR_API_TOKEN

コマンドの例

Claude に次のように依頼できます。

• 「自分の組織を一覧表示して」
• 「組織 ABC123 に「MyProject」という新しいプロジェクトを作成して」
• 「プロジェクト XYZ789 のすべての環境を一覧表示して」
• 「環境 ENV123 を起動して」
• 「コンポーネント COMP456 をデプロイして」
• 「環境 ENV123 に「DATABASE_URL」という変数を作成して」

開発

プロジェクト構成

.
├── 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 の設定

.cursor/mcp.json ファイルには、Cursor の MCP サーバー設定が含まれています。

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

Docker セットアップの場合は、次を使用します。

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

注： Bunnyshell API トークンを env セクションに追加すると、各コマンドでトークンを指定しなくても、MCP サーバーが自動的に認証に使用します。コードはすでに BNS_API_KEY 環境変数を確認します。これは、開発や個人での使用に特に便利です。共有環境では、設定ファイルにトークンを含めず、会話中に指定することをおすすめします。

ビルド

npm install
npm run build

テストの実行

npm test

セキュリティ

• API トークンがコードや設定ファイルに保存されることはありません
• トークンは次の方法で指定できます。
  • コマンドラインオプション
  • 環境変数（BNS_API_KEY）
  • セッションストレージ（一時的で、メモリ内にのみ保存）
• コマンドのログには機密情報が含まれません

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. Pull Request を作成します

ライセンス

MIT ライセンス