# Firefly III MCP Server

Servidor MCP para integrar la API de Firefly III con agentes de IA y flujos de automatización.
Implementado usando el SDK oficial `@modelcontextprotocol/server` (v2) con transporte Streamable HTTP (stateless).

## Características

- 🚀 SDK v2 de Model Context Protocol (Stateless, Web-standard)
- 🔌 Transporte HTTP Streamable
- 🛡️ Autenticación mediante `MCP_API_KEY` (Bearer Token)
- 📊 Paginación, limitación de tamaño y formato dual (JSON / Markdown)
- 🐳 Despliegue en contenedor Docker

## Requisitos Previos

- Contenedor de Firefly III corriendo en Docker.
- Personal Access Token de Firefly III (En tu perfil de Firefly > OAuth > Personal Access Tokens).

## Configuración y Despliegue (Local / Producción)

1. **Configurar el entorno**
   Copia el archivo de ejemplo para configurar tus claves:
   ```bash
   cp firefly-mcp/.env.example firefly-mcp/.env
   ```
   Abre `.env` y edita:
   - `FIREFLY_PAT`: Tu Personal Access Token.
   - `MCP_API_KEY`: Genera una clave segura.

2. **Arrancar el entorno**
   Agregar al docker-compose de firefly-iii
   ```bash
   docker compose up -d
   ```