Firefly MCP

🚀 Firefly MCP サーバー

Firefly MCP（モデルコンテキストプロトコル）サーバーは、TypeScript をベースにしたサーバーで、Firefly プラットフォームとのシームレスな統合を実現します。これにより、Firefly に接続されたクラウドおよび SaaS アカウント内のリソースを発見、管理、コード化することができます。

✨ 主な機能

• 🔍 リソース発見：すべてのクラウドおよび 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 の認証情報は、以下の 2 つの方法で提供できます。

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

💻 使用例

基本的な使用法

標準入出力

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 モデルコンテキストプロトコルドキュメント を参照してください。
3. 自然言語でリソースをクエリします。

例：

プロンプト

123456789012 AWS アカウント内のすべての「ubuntu - prod」EC2 インスタンスを検索し、Terraform コードに変換します。

レスポンス

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

高度な使用法

デモンストレーション

デモンストレーションリンク

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'feat: Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。詳細は LICENSE ファイルを参照してください。

🛠️ サポート

サポートが必要な場合は、Firefly のドキュメント を参照するか、このリポジトリで問題を作成してください。