Firefly

by gofireflyio

5 stars

1.5k downloads

Not rated

GitHub Website

About

Bridges to Firefly.ai's cloud infrastructure platform, enabling inventory queries across providers and Terraform code generation for discovered resources.

Details

Author: gofireflyio
Repository: gofireflyio/firefly-mcp
GitHub stars: 5
Downloads: 1,547
License: MIT License
Categories: Developer Tools, Design, Workplace, AI, Search, Cloud Service, Infrastructure, Frontend, Other
Tags: #integration

- 🔍 Resource Discovery: Find any resource in your Cloud and SaaS accounts
- 📝 Resource Codification: Convert discovered resources into Infrastructure as Code
- 🔐 Secure Authentication: Uses FIREFLY_ACCESS_KEY and FIREFLY_SECRET_KEY for secure communication
- 🚀 Easy Integration: Works seamlessly with Claude and Cursor

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Firefly

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @fireflyai/firefly-mcp
Environment
- FIREFLY_ACCESS_KEY your_access_key
- FIREFLY_SECRET_KEY your_secret_key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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 arguments:

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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 across your Cloud and SaaS accounts connected to Firefly.

Features

Prerequisites

- Node.js (v20 or higher)
- npm or yarn
- 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 arguments:

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

Usage

Stdio

Update the mcp.json file with the following:

{
  "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 one of the methods above with the following command:

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

Update the mcp.json file with the following:

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

Using with Cursor

1. Start the MCP server using one of the methods above
2. Use the Cursor extension to connect to the MCP server - see Cursor Model Context Protocol documentation
3. Use natural language to query your resources

Example:

Prompt

Find all "ubuntu-prod" EC2 instance in 123456789012 AWS account and codify it into Terraform

Response

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

Demo

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

Firefly MCP Server

Features

Prerequisites

Installation

Environment Variables

Usage

Stdio

Using with Cursor

Example:

Prompt

Response

Demo

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright