floci-mcp

AIエージェントがローカルの Floci インスタンス上でAWS形式のリソースをデプロイおよび管理できるようにするMCPサーバーです。「これらのパラメータでEC2インスタンスを起動して」「S3バケットとDynamoDBテーブルを作成して」などといった指示に対応します。

機能

Floci は http://localhost:4566 上で76のAWSサービスをエミュレートします。floci-mcp はそのエンドポイントを、MCP互換の任意のクライアントに3つのツールとして公開します:

• aws_call(service, action, params) — Floci に対して任意のAWS API操作（任意のサービス、任意のアクション）を呼び出します。これはコアツールです。AWS APIへの薄いパススルーであるため、操作ごとに手作りのツールを用意することなく、76すべてのサービスをカバーします。

• floci_status() — Floci に到達可能かどうかを確認します。

• floci_inventory() — S3、DynamoDB、Lambda、EC2、SQS、SNS、ECS、RDS に現在デプロイされているものを1回の呼び出しで要約します。

Related MCP server: AWS MCP Server

前提条件

• Python 3.10+

• 実行中の Floci インスタンス — Floci README で floci start または Docker セットアップを参照してください。

インストール

クローンから（まだ PyPI に公開されていません）:

git clone https://github.com/Awilliv/floci-mcp.git
cd floci-mcp
pip install -e .

PyPI に公開されたら:

pip install floci-mcp

設定

環境変数（すべてオプション）:

使用例

MCP クライアントに登録したら、エージェントに次のようなことを依頼します:

「t3.micro インスタンスタイプで ami-00000000 を使用して EC2 インスタンスを起動して」

「reports という S3 バケットと、パーティションキー id を持つ users という DynamoDB テーブルを作成して」

エージェントはこれらを aws_call を通じて実行します。エージェントは AWS API のパラメータ形状をすでに知っているため、動作するためにサービスごとのツールは必要ありません。

MCP クライアントへの登録

Claude Code

ここで AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY を明示的に設定することで（起動シェルの環境に依存するのではなく）、他の場所で実際の AWS 認証情報をエクスポートしている場合に、誤ってリクエストに署名してしまうことを防ぎます。

claude mcp add floci -- floci-mcp

または .mcp.json に追加:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Open WebUI (via mcpo)

Open WebUI は MCP を直接話すのではなく、OpenAPI/ツール呼び出しを話します。floci-mcp を mcpo で前面に配置して、OpenAPI サーバーとして公開します:

pip install mcpo
mcpo --port 8000 -- floci-mcp

次に Open WebUI で、Settings → Tools → Add a Tool Server に移動し、http://localhost:8000 を追加します。mcpo は起動する floci-mcp プロセスに環境変数を渡すので、mcpo を実行するシェルで FLOCI_ENDPOINT_URL などを事前に設定してください。

開発

pip install -e ".[test]"
pytest

tests/test_integration.py の統合テストは、実行中の Floci インスタンスを必要とし、到達できない場合は自動的にスキップされます。

ライセンス

MIT