Servidor MCP de Firefly III - Cloudflare Worker

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

查看中文版

Características

• Despliegue global en el borde basado en Cloudflare Workers

• Servicio de baja latencia y alta disponibilidad

• Sin necesidad de mantenimiento de servidores

• Integración perfecta con la API de Firefly III

• Soporte de filtrado de herramientas mediante ajustes predefinidos o etiquetas personalizadas

Related MCP server: Firefly III MCP Server

Métodos de Despliegue

Despliegue con un Solo Clic

El método más sencillo es usar el botón "Deploy to Cloudflare Workers" para un despliegue con 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, debes configurar las siguientes variables de entorno en la configuración de tu Cloudflare Workers:

Variables Requeridas

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

• FIREFLY_III_PAT: Tu Token de Acceso Personal de Firefly III

Variables Opcionales

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

• FIREFLY_III_TOOLS: Lista separada por comas de etiquetas de herramientas a habilitar (anula FIREFLY_III_PRESET si ambos están configurados)

Ajustes Predefinidos Disponibles

• default: Herramientas básicas para uso diario (cuentas, facturas, categorías, etiquetas, transacciones, búsqueda, resumen)

• 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 requeridas 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 la configuración de Cloudflare Workers. Para los pasos específicos, consulta la documentación de Cloudflare.

Detalles Técnicos

Este paquete está construido con el framework Hono y aprovecha las capacidades de computación en el borde de Cloudflare Workers.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.