Firefly III MCP 服务器

npm version License: MIT

一个 MCP (Model Context Protocol) 服务器，让 Claude 可以完全访问您的 Firefly III 个人理财实例。通过自然语言与 Claude 对话，即可记录支出、查询余额、管理预算等。

功能特性

交易：创建、列出、搜索、更新和删除交易（支出、收入、转账）
账户：管理资产、支出、收入、负债和现金账户
类别：使用类别整理交易
预算：创建和管理预算，支持自动预算
标签：使用灵活的标签标记交易

前置要求

Node.js >= 18
一个正在运行的 Firefly III 实例
来自您的 Firefly III 实例的个人访问令牌 (PAT)

获取您的 PAT

登录您的 Firefly III 实例
前往 Options → Profile → OAuth
在 Personal Access Tokens 下，创建一个新令牌
复制该令牌 — 配置时需要用到

安装

通过 npm (推荐)

npm install -g firefly-iii-mcp-server

从源码安装

git clone https://github.com/przbadu/firefly-iii-mcp-server.git
cd firefly-iii-mcp-server
npm install
npm run build

配置

Claude Desktop

编辑您的 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

使用 npm 安装的二进制文件：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "firefly-iii-mcp-server",
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

或者使用 npx（无需全局安装）：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Claude Code CLI

claude mcp add firefly-iii \
  -e FIREFLY_III_URL=https://your-firefly-instance.example.com \
  -e FIREFLY_III_PAT=your-personal-access-token-here \
  -- npx -y firefly-iii-mcp-server

或者将其添加到您的 .claude/settings.json 中：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

使用示例

配置完成后，只需自然地与 Claude 对话：

记录交易

"我今天在 Trader Joe's 买杂货花了 45.50 美元"

"记录一笔 2,500 美元的工资收入，存入我的支票账户"

"从支票账户转账 500 美元到储蓄账户"

查询

"显示我上周的所有交易"

"我这个月在餐厅花了多少钱？"

"我的支票账户余额是多少？"

管理财务

"创建一个 600 美元的每月杂货预算"

"列出我所有的支出类别"

"将我最近的 3 笔餐厅交易标记为 '商务餐'"

可用工具

工具	描述
`firefly_create_transaction`	创建支出、收入或转账
`firefly_list_transactions`	带过滤条件列出交易
`firefly_get_transaction`	通过 ID 获取交易详情
`firefly_update_transaction`	更新现有交易
`firefly_delete_transaction`	删除交易
`firefly_search_transactions`	使用 Firefly III 查询语法进行搜索
`firefly_create_account`	创建新账户
`firefly_list_accounts`	按类型列出账户
`firefly_get_account`	获取账户详情
`firefly_update_account`	更新账户属性
`firefly_delete_account`	删除账户
`firefly_list_categories`	列出所有类别
`firefly_create_category`	创建类别
`firefly_update_category`	更新类别
`firefly_delete_category`	删除类别
`firefly_list_budgets`	列出所有预算
`firefly_create_budget`	创建预算
`firefly_update_budget`	更新预算
`firefly_delete_budget`	删除预算
`firefly_list_tags`	列出所有标签
`firefly_create_tag`	创建标签
`firefly_update_tag`	更新标签
`firefly_delete_tag`	删除标签

开发

# Watch mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

许可证

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Firefly III MCP Server