AI导哈

Firefly III MCP服务器

Firefly III MCP服务器是一个基于Cloudflare Workers的模型上下文协议服务器，提供低延迟、高可用性的服务，无需服务器维护，并支持与Firefly III API的无缝集成。

  • by gregbtm
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gregbtm/firefly-iii-mcp

使用说明

Firefly III MCP服务器 - Cloudflare Worker

这个包在Cloudflare Workers上提供了Firefly III MCP（模型上下文协议）服务器的实现。借助Cloudflare Workers，您可以轻松地将MCP服务器部署到云端，并享受全球边缘网络带来的性能优势。

查看中文版

功能

  • 基于Cloudflare Workers的全局边缘部署
  • 低延迟、高可用性服务
  • 无需服务器维护
  • 与Firefly III API无缝集成
  • 通过预设或自定义标签支持工具过滤

部署方法

一键部署

最简单的方法是使用“部署到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工具预设要使用的（默认、完整、基本、经济、报告、管理、自动化）
  • 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的人工智能工具，以便它们能够与您的Firefly III实例进行交互。

自定义域名

如果您想使用自己的域名，可以在Cloudflare Workers设置中配置自定义域名。具体步骤，请参阅 Cloudflare文档根据上面的信息，执行如下指令：您是个专业的翻译，负责把中文内容翻译成中文内容，请帮我翻译一下原文内容（但原文内容在此处为空）。

技术细节

这个包是使用 Hono 框架并利用了Cloudflare Workers的边缘计算能力。

许可证

这个项目采用以下许可协议： 麻省理工学院许可证根据上面的信息，执行如下指令：你是个专业的翻译，负责把中文内容翻译成中文内容，请帮我翻译一下原文内容（但此处原文内容为空，因此无法提供具体翻译）。

相关 MCP