Bns MCP Server

🚀 兔子壳 MCP サーバー

このプロジェクトは、CLI インターフェースを通じて Bunnyshell プラットフォームとやり取りするための Model Context Protocol (MCP) サーバーの実装です。AI アシスタント（Claude など）が自然言語コマンドで Bunnyshell プラットフォームとやり取りできるようになります。

🚀 クイックスタート

この MCP サーバーを使用することで、AI アシスタント（Claude など）が自然言語コマンドを介して Bunnyshell プラットフォームとやり取りできるようになります。サーバーは、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. '+' をクリックして添付ファイルを追加し、'MCP サーバーに接続' を選択します。
4. サーバーリストから 'bunnyshell - mcp' を選択します。
5. Bunnyshell API トークンを設定します：

token: あなたの_API_トークン

サンプルコマンド

Claude に次の操作を要求できます：

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

📚 ドキュメント

プロジェクト構造

.
├── src/
│   ├── tools.ts       # ツールの実装
│   ├── utils.ts       # ユーティリティ関数
│   └── index.ts       # サーバーのエントリポイント
├── .cursor/
│   └── mcp.json      # Cursor MCP 設定ファイル
├── setup.sh          # ローカルセットアップスクリプト
├── docker-setup.sh   # Docker セットアップスクリプト
└── README.md         # 説明ドキュメント

カーソル MCP の使用

{
  "version": "1.0",
  "mcpServers": {
    "bunnyshell-mcp": {
      "url": "http://localhost:3000"
    }
  }
}

🤝 貢献ガイド

貢献する場合は、プロジェクトリポジトリの CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

📞 連絡先

フィードバックや質問がある場合は、project maintainers に連絡してください。