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 文件。