Firefly MCP

🚀 Firefly MCP Server

The Firefly MCP (Model Context Protocol) Server is a TypeScript-based server that enables seamless integration with the Firefly platform. It allows you to discover, manage, and codify resources into your cloud and SaaS accounts connected to Firefly.

✨ Features

• 🔍 Resource Discovery: Find any resource across all your cloud and SaaS accounts.
• 📝 Resource Codification: Transform discovered resources into Infrastructure as Code.
• 🔐 Secure Authentication: Communicate securely using FIREFLY_ACCESS_KEY and FIREFLY_SECRET_KEY.
• 🚀 Easy Integration: Collaborate seamlessly with Claude and Cursor.

📦 Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• A Firefly account with generated access keys

📦 Installation

You can run the Firefly MCP Server directly using NPX:

npx @fireflyai/firefly-mcp

Environment Variables

You can provide your Firefly credentials in two ways:

1. Using environment variables:

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

2. Using command-line arguments:

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

💻 Usage Examples

Standard Input and Output

Update the mcp.json file as follows:

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

Run the MCP Server using the following command:

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

Update the mcp.json file as follows:

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

Using with Cursor

1. Start the MCP Server using one of the methods described above.
2. Connect to the MCP Server using the Cursor extension - see Cursor Model Context Protocol Documentation.
3. Query your resources using natural language.

Example:

Prompt

Find all "ubuntu-prod" EC2 instances in the 123456789012 AWS account and codify them into Terraform.

Response

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

🎥 Example Demonstration

https://github.com/user-attachments/assets/0986dff5-d433-4d82-9564-876b8215b61e

🤝 Contribution

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'feat: Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is distributed under the MIT License - see the LICENSE file for details.

🛠️ Support

For support, visit Firefly's Documentation or create an issue in this repository.