Firefly III MCP Server - Cloudflare Worker

Этот пакет представляет собой реализацию сервера Firefly III MCP (Model Context Protocol) на базе Cloudflare Workers. С помощью Cloudflare Workers вы можете легко развернуть MCP-сервер в облако и воспользоваться преимуществами производительности глобальной периферийной сети.

查看中文版

Возможности

• Глобальное периферийное развертывание на базе Cloudflare Workers

• Низкая задержка и высокая доступность сервиса

• Не требуется обслуживание сервера

• Бесшовная интеграция с Firefly III API

• Поддержка фильтрации инструментов через пресеты или пользовательские теги

Related MCP server: Firefly III MCP Server

Способы развертывания

Развертывание в один клик

Самый простой способ — использовать кнопку «Deploy to Cloudflare Workers» для развертывания в один клик:

Ручное развертывание

1. Клонируйте этот репозиторий:

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

2. Установите зависимости:

   npm install

3. Соберите проект:

   npm run build

4. Разверните на Cloudflare Workers:

   cd packages/cloudflare-worker
   npm run deploy

Конфигурация

После развертывания необходимо настроить следующие переменные окружения в настройках Cloudflare Workers:

Обязательные переменные

• FIREFLY_III_BASE_URL: URL вашего экземпляра Firefly III (например, https://firefly.yourdomain.com)

• FIREFLY_III_PAT: ваш персональный токен доступа к Firefly III

Необязательные переменные

• FIREFLY_III_PRESET: используемый пресет инструментов (default, full, basic, budget, reporting, admin, automation)

• FIREFLY_III_TOOLS: разделенный запятыми список тегов инструментов для включения (переопределяет FIREFLY_III_PRESET, если заданы оба)

Доступные пресеты

• default: базовые инструменты для повседневного использования (счета, счета к оплате, категории, теги, транзакции, поиск, сводка)

• full: все доступные инструменты

• basic: базовые инструменты управления финансами

• budget: инструменты, ориентированные на бюджет

• reporting: инструменты для отчетности и анализа

• admin: инструменты администрирования

• automation: инструменты, связанные с автоматизацией

Шаги настройки

1. Перейдите в свой дашборд Cloudflare

2. Перейдите в раздел Workers & Pages

3. Выберите развернутый вами Worker

4. Перейдите в раздел Settings > Variables

5. Добавьте обязательные и необязательные переменные как секретные переменные

Использование

После развертывания и настройки вы можете получить доступ к MCP-серверу по следующему URL:

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

Вы можете передать этот URL-адрес MCP-совместимым ИИ-инструментам, чтобы они могли взаимодействовать с вашим экземпляром Firefly III.

Пользовательский домен

Если вы хотите использовать собственный домен, вы можете настроить пользовательский домен в настройках Cloudflare Workers. Конкретные шаги см. в документации Cloudflare.

Технические детали

Этот пакет создан на основе фреймворка Hono и использует возможности периферийных вычислений Cloudflare Workers.

Лицензия

Этот проект распространяется под лицензией MIT License.