Firefly III MCP 服务器 - Cloudflare Worker

本包提供了在 Cloudflare Workers 上实现的 Firefly III MCP（模型上下文协议）服务器。借助 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：日常使用的基础工具（账户、账单、类别、标签、交易、搜索、摘要）

• full：所有可用工具

• basic：核心财务管理工具

• budget：预算相关工具

• reporting：报告与分析工具

• admin：管理工具

• automation：自动化相关工具

配置步骤

1. 前往 Cloudflare 控制台

2. 导航到 Workers & Pages

3. 选择您已部署的 Worker

4. 进入“设置”>“变量”

5. 添加必需变量和可选变量作为机密变量

使用方法

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

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

您可以将此 URL 提供给兼容 MCP 的 AI 工具，使其能够与您的 Firefly III 实例进行交互。

自定义域名

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

技术细节

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

许可证

本项目基于 MIT 许可证 授权。