Firefly III MCP Server - Cloudflare Worker

Este paquete proporciona una implementación del servidor MCP (Model Context Protocol) del Firefly III en Cloudflare Workers. Con Cloudflare Workers, puedes desplegar fácilmente el servidor MCP en la nube y aprovechar las ventajas de rendimiento de una red de borde global.

Ver la versión en chino

Características

• Despliegue global de borde basado en Cloudflare Workers

• Servicio de baja latencia y alta disponibilidad

• No se requiere mantenimiento de servidores

• Integración perfecta con la API de Firefly III

• Soporte de filtrado de herramientas mediante presets o etiquetas personalizadas

Related MCP server: Firefly III MCP Server

Métodos de despliegue

Despliegue en un clic

El método más sencillo es usar el botón "Deploy to Cloudflare Workers" para el despliegue en un solo clic:

Despliegue manual

1. Clona este repositorio:

   git clone https://github.com/etnperlong/firefly-iii-mcp.git
   cd firefly-iii-mcp

2. Instala las dependencias:

   npm install

3. Compila el proyecto:

   npm run build

4. Despliega en Cloudflare Workers:

   cd packages/cloudflare-worker
   npm run deploy

Configuración

Después del despliegue, deberás configurar las siguientes variables de entorno en los ajustes de Cloudflare Workers:

Variables obligatorias

• FIREFLY_III_BASE_URL: La URL de tu instancia de Firefly III (p. ej., https://firefly.yourdomain.com)

• FIREFLY_III_PAT: Tu token de acceso personal de Firefly III

Variables opcionales

• FIREFLY_III_PRESET: Preset de herramientas a utilizar (default, full, basic, budget, reporting, admin, automation)

• FIREFLY_III_TOOLS: Lista de etiquetas de herramientas separadas por comas para activar (anula FIREFLY_III_PRESET si ambas están configuradas)

Presets disponibles

• default: Herramientas básicas para el uso diario (accounts, bills, categories, tags, transactions, search, summary)

• full: Todas las herramientas disponibles

• basic: Herramientas básicas de gestión financiera

• budget: Herramientas centradas en presupuestos

• reporting: Herramientas de informes y análisis

• admin: Herramientas de administración

• automation: Herramientas relacionadas con la automatización

Pasos de configuración

1. Ve a tu panel de Cloudflare.

2. Navega a Workers & Pages.

3. Selecciona tu Worker desplegado.

4. Ve a Configuración > Variables.

5. Añade las variables obligatorias y opcionales como variables secretas.

Uso

Una vez desplegado y configurado, puedes acceder al servidor MCP en la siguiente URL:

https://your-worker-name.your-account.workers.dev/mcp

Puedes proporcionar esta URL a herramientas de IA compatibles con MCP para que puedan interactuar con tu instancia de Firefly III.

Dominio personalizado

Si quieres usar tu propio dominio, puedes configurar un dominio personalizado en los ajustes de Cloudflare Workers. Para ver los pasos concretos, consulta la documentación de Cloudflare.

Detalles técnicos

Este paquete está construido con el framework Hono y aprovecha las capacidades de edge computing de Cloudflare Workers.

Licencia

Este proyecto está bajo la Licencia MIT.