Bns MCP Server

🚀 兔子殼 MCP 服務器

兔子殼 MCP 服務器是一個基於 Model Context Protocol (MCP) 的實現，藉助其 CLI 接口，可讓 AI 助手（如 Claude）通過自然語言命令與 Bunnyshell 平臺進行交互，為管理和操作 Bunnyshell 資源提供了便捷的工具。

🚀 快速開始

該項目創建的 MCP 服務器，能讓 AI 助手（像 Claude）通過自然語言命令與 Bunnyshell 平臺交互。服務器提供了一系列工具，用於管理和操作您的 Bunnyshell 資源。

✨ 主要特性

• 組織管理：可列出和導航組織。
• 項目管理：支持創建、列出和刪除項目。
• 環境管理：能夠創建、列出、啟動、停止和刪除環境。
• 組件操作：可部署、調試和 SSH 進入組件。
• 變量與密鑰管理：方便管理環境變量和密鑰。
• 遠程開發：能啟動遠程開發會話並設置端口轉發。

📦 安裝指南

先決條件

• 需要安裝 Node.js 18+ 和 npm。
• 已安裝並配置好的 Bunnyshell CLI（bns）。
• 需安裝 Claude Desktop。
• 若進行 Docker 設置，要安裝 Docker 及 Docker Compose。

本地設置

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

💻 使用示例

基礎用法

使用該 MCP 服務器與 Claude 交互的步驟如下：

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。

聯繫方式

如需反饋或問題，請聯繫 project maintainers。

📄 許可證

項目使用 MIT License。