Сервер Firefly III MCP - 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: базовые инструменты для повседневного использования (accounts, bills, categories, tags, transactions, search, summary)

• 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.