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：您的 Firefly III 实例 URL（例如 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. 将必需变量和可选变量添加为机密变量

使用方法

部署并配置完成后，您可以通过以下 URL 访问 MCP 服务器：

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

您可以将此 URL 提供给兼容 MCP 的 AI 工具，以便它们与您的 Firefly III 实例进行交互。

自定义域名

如果您想使用自己的域名，可以在 Cloudflare Workers 设置中配置自定义域名。具体步骤请参阅 Cloudflare 文档。

技术详情

本包基于 Hono 框架构建，并利用了 Cloudflare Workers 的边缘计算能力。

许可证

本项目采用 MIT License 许可证。