floci-mcp

MCP-Server, der es einem KI-Agenten ermöglicht, AWS-förmige Ressourcen auf einer lokalen Floci-Instanz bereitzustellen und zu verwalten – „EC2-Instanz mit diesen Parametern hochfahren“, „S3-Bucket und DynamoDB-Tabelle erstellen“ usw.

Was es tut

Floci emuliert 76 AWS-Dienste unter http://localhost:4566. floci-mcp stellt diesen Endpunkt jedem MCP-kompatiblen Client als drei Tools zur Verfügung:

• aws_call(service, action, params) — jede AWS-API-Operation (beliebiger Dienst, beliebige Aktion) gegen Floci aufrufen. Dies ist das Kern-Tool: Da es ein dünner Durchgriff auf die AWS-API ist, deckt es alle 76 Dienste ab, ohne dass ein handgebautes Tool pro Operation nötig ist.

• floci_status() — prüfen, ob Floci erreichbar ist.

• floci_inventory() — zusammenfassen, was derzeit über S3, DynamoDB, Lambda, EC2, SQS, SNS, ECS und RDS bereitgestellt ist, in einem Aufruf.

Related MCP server: AWS MCP Server

Voraussetzungen

• Python 3.10+

• Eine laufende Floci-Instanz – siehe Floci README für floci start oder Docker-Setup.

Installation

Aus einem Klon (noch nicht auf PyPI veröffentlicht):

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

Sobald auf PyPI veröffentlicht:

pip install floci-mcp

Konfiguration

Umgebungsvariablen, alle optional:

Verwendungsbeispiele

Sobald Sie bei einem MCP-Client registriert sind, fragen Sie den Agenten zum Beispiel:

„Starten Sie eine EC2-Instanz mit dem Instanztyp t3.micro mit ami-00000000“

„Erstellen Sie einen S3-Bucket namens reports und eine DynamoDB-Tabelle namens users mit einem Partitionsschlüssel id“

Der Agent steuert diese über aws_call – er kennt bereits die AWS-API-Parameterformen, sodass kein pro-Dienst-Tool existieren muss, damit es funktioniert.

Registrierung bei einem MCP-Client

Claude Code

Das explizite Setzen von AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY hier (anstatt sich auf die Umgebung der startenden Shell zu verlassen) vermeidet, dass Anfragen versehentlich mit echten AWS-Anmeldedaten signiert werden, falls Sie diese anderswo exportiert haben.

claude mcp add floci -- floci-mcp

Oder fügen Sie zu .mcp.json hinzu:

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

Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

{
  "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 spricht OpenAPI/Tool-Calling, nicht direkt MCP. Stellen Sie floci-mcp mit mcpo vor, um es als OpenAPI-Server bereitzustellen:

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

Gehen Sie dann in Open WebUI zu Einstellungen → Tools → Tool-Server hinzufügen und fügen Sie http://localhost:8000 hinzu. mcpo reicht Umgebungsvariablen an den von ihm gestarteten floci-mcp-Prozess weiter. Setzen Sie also FLOCI_ENDPOINT_URL usw. in der Shell, aus der Sie mcpo ausführen, bevor Sie es starten.

Entwicklung

pip install -e ".[test]"
pytest

Integrationstests in tests/test_integration.py erfordern eine laufende Floci-Instanz und überspringen sich automatisch, wenn keine erreichbar ist.

Lizenz

MIT