Firefly MCP

🚀 Firefly MCP 服務器

Firefly MCP（模型上下文協議）服務器是一款基於 TypeScript 的服務器，它能與 Firefly 平臺實現無縫集成。藉助該服務器，您可以在已連接到 Firefly 的雲和 SaaS 賬戶中，輕鬆發現、管理並將資源編化。

🚀 快速開始

在開始使用 Firefly MCP 服務器之前，您需要滿足一些先決條件，然後進行安裝和配置，即可開啟使用之旅。

✨ 主要特性

• 🔍 資源發現：可查找所有云和 SaaS 賬戶中的任何資源。
• 📝 資源編化：能將發現的資源轉換為基礎設施即代碼（Infrastructure as Code）。
• 🔐 安全認證：使用 FIREFLY_ACCESS_KEY 和 FIREFLY_SECRET_KEY 進行安全通信。
• 🚀 易於集成：可與 Claude 和 Cursor 無縫協作。

📦 安裝指南

先決條件

• Node.js (v14 或更高版本)
• npm 或 yarn
• 帶有生成訪問密鑰的 Firefly 賬戶

安裝命令

您可以直接使用 NPX 運行 Firefly MCP 服務器：

npx @fireflyai/firefly-mcp

環境變量

您可以通過以下兩種方式提供您的 Firefly 憑據：

1. 使用環境變量：

FIREFLY_ACCESS_KEY=your_access_key FIREFLY_SECRET_KEY=your_secret_key npx @fireflyai/firefly-mcp

2. 使用命令行參數：

npx @fireflyai/firefly-mcp --access-key your_access_key --secret-key your_secret_key

💻 使用示例

標準輸入輸出

步驟 1：更新 mcp.json 文件

{
  "mcpServers": {
    "firefly": {
      "command": "npx",
      "args": ["-y", "@fireflyai/firefly-mcp"],
      "env": {
        "FIREFLY_ACCESS_KEY": "your_access_key",
        "FIREFLY_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

步驟 2：運行 MCP 服務器

npx @fireflyai/firefly-mcp --sse --port 6001

步驟 3：再次更新 mcp.json 文件

{
  "mcpServers": {
    "firefly": {
      "url": "http://localhost:6001/sse"
    }
  }
}

與 Cursor 結合使用

步驟 1：啟動 MCP 服務器

使用上述安裝部分提到的方法之一啟動 MCP 服務器。

步驟 2：連接到 MCP 服務器

使用 Cursor 擴展連接到 MCP 服務器 - 參見 Cursor 模型上下文協議文檔。

步驟 3：查詢資源

使用自然語言查詢您的資源。

示例：

提示

查找所有“ubuntu-prod”EC2 實例在 123456789012 AWS 賬戶中，並將其編化為 Terraform

響應

resource "aws_instance" "ubuntu-prod" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
}

📚 詳細文檔

示例演示

您可以通過以下鏈接查看示例演示： https://github.com/user-attachments/assets/0986dff5-d433-4d82-9564-876b8215b61e

貢獻

如果您想為該項目做出貢獻，可以按照以下步驟進行：

1. 叉存倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'feat: Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開 Pull Request

支持

如需支持，請訪問 Firefly 的文檔 或在此倉庫中創建問題。

📄 許可證

本項目根據 MIT License 分發 - 詳細信息請參閱 LICENSE 文件。