Firefly MCP Server

Firefly MCP 服务

Firefly MCP（Model Context Protocol）服务是一个基于 TypeScript 的服务，可与 Firefly 平台无缝集成。它可以帮助你发现、管理并将连接到 Firefly 的云和 SaaS 账户中的资源转换为代码。

功能

• 🔍 资源发现：查找云和 SaaS 账户中的任意资源
• 📝 资源代码化：将发现的资源转换为基础设施即代码
• 🔐 安全认证：使用 FIREFLY_ACCESS_KEY 和 FIREFLY_SECRET_KEY 进行安全通信
• 🚀 轻松集成：与 Claude 和 Cursor 无缝协作

先决条件

• Node.js（v20 或更高版本）
• 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

使用方法

Stdio

使用以下内容更新 mcp.json 文件：

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

使用上述任一方法运行 MCP 服务，并执行以下命令：

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

使用以下内容更新 mcp.json 文件：

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

与 Cursor 搭配使用

1. 使用上述任一方法启动 MCP 服务
2. 使用 Cursor 扩展连接到 MCP 服务——请参阅 Cursor Model Context Protocol 文档
3. 使用自然语言查询资源

示例：

提示词

Find all "ubuntu-prod" EC2 instance in 123456789012 AWS account and codify it into 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. Fork 此仓库
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

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

支持

如需支持，请访问 Firefly 文档，或在此仓库中创建 issue。