floci-mcp

Servidor MCP que permite a un agente de IA desplegar y gestionar recursos con forma de AWS en una instancia local de Floci — «inicia una instancia EC2 con estos parámetros», «crea un bucket S3 y una tabla DynamoDB», etc.

Qué hace

Floci emula 76 servicios de AWS en http://localhost:4566. floci-mcp expone ese endpoint a cualquier cliente compatible con MCP como tres herramientas:

• aws_call(service, action, params) — llama a cualquier operación de la API de AWS (cualquier servicio, cualquier acción) contra Floci. Esta es la herramienta principal: al ser un paso directo a la API de AWS, cubre los 76 servicios sin necesidad de una herramienta específica por operación.

• floci_status() — comprueba si Floci es accesible.

• floci_inventory() — resume lo que está desplegado actualmente en S3, DynamoDB, Lambda, EC2, SQS, SNS, ECS y RDS en una sola llamada.

Related MCP server: AWS MCP Server

Requisitos previos

• Python 3.10+

• Una instancia de Floci en ejecución — consulta el README de Floci para floci start o la configuración con Docker.

Instalación

Desde un clon (aún no publicado en PyPI):

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

Una vez publicado en PyPI:

pip install floci-mcp

Configuración

Variables de entorno, todas opcionales:

Ejemplos de uso

Una vez registrado con un cliente MCP, pide al agente cosas como:

«Inicia una instancia EC2 con un tipo de instancia t3.micro usando ami-00000000»

«Crea un bucket S3 llamado reports y una tabla DynamoDB llamada users con una clave de partición id»

El agente realiza estas acciones mediante aws_call — ya conoce las formas de los parámetros de la API de AWS, por lo que no necesita existir una herramienta específica por servicio para que funcione.

Registro con un cliente MCP

Claude Code

Establecer AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY explícitamente aquí (en lugar de depender del entorno del shell que lo lanza) evita firmar accidentalmente solicitudes con credenciales reales de AWS si las tienes exportadas en otro lugar.

claude mcp add floci -- floci-mcp

O añade a .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

Añade a 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 (a través de mcpo)

Open WebUI habla OpenAPI/llamada a herramientas, no MCP directamente. Intercala floci-mcp con mcpo para exponerlo como un servidor OpenAPI:

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

Luego, en Open WebUI, ve a Configuración → Herramientas → Añadir un servidor de herramientas y añade http://localhost:8000. mcpo pasa las variables de entorno al proceso floci-mcp que lanza, así que establece FLOCI_ENDPOINT_URL etc. en el shell desde el que ejecutas mcpo antes de iniciarlo.

Desarrollo

pip install -e ".[test]"
pytest

Las pruebas de integración en tests/test_integration.py requieren una instancia de Floci en ejecución y se omiten automáticamente cuando no se puede acceder a una.

Licencia

MIT