Skip to main content
Glama
firefly-iii-mcp

firefly-iii-mcp

by Drumfire01

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”按钮进行一键部署:

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 许可证 授权。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI tools to interact with Firefly III personal finance management instances through a cloud-deployed MCP server. Supports financial operations like account management, transactions, budgeting, and reporting with configurable tool presets.
      19 npm
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables interaction with Firefly III personal finance management instances via the Firefly III API, deployed as a Cloudflare Worker. It allows AI tools to manage transactions, accounts, budgets, and reporting through natural language.
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI tools to interact with Firefly III personal finance manager through the MCP protocol, deployed globally on Cloudflare Workers for low latency.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Firefly III personal finance tools through natural language, deployed globally on Cloudflare Workers for low latency and high availability.
      19 npm
      ISC