独立运营 · 不出售排名位置  · 我们怎么评估工具 →
Anclum 提交收录
Y

YakupEmreYerli/mcp-firefly-iii

本站为独立目录,非该工具官网;下方信息取自其公开仓库。

4 ★ 本站实测 · 核对 2026-11-19

装之前:没有可直接复制的命令 · 许可证 MIT

第一步:这条暂时没有可执行的下一步,可先看原仓库 https://github.com/YakupEmreYerli/mcp-firefly-iii

★ 4·更新 2026-11-16
在 GitHub 查看 ↗直链 · 无中转页

我们没有从该仓库取到可核对的安装命令,也没有公开的远端端点。这两样都没有时,我们不出配置——编一条出来比不给更糟。 各客户端的接法 →

★ 数取值
4 ★ · YakupEmreYerli/mcp-firefly-iii · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
来源明细
收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
收录与活跃
收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
评分构成
综合分 300 · 4 ★ · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库 YakupEmreYerli/mcp-firefly-iii;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。
README 原文(英文,未翻译) · 在 GitHub 读完整 README →

# Firefly III MCP Server

以下摘录自该仓库的 README(片段)

A Model Context Protocol server that gives an AI assistant access to your own Firefly III instance — 152 operations behind 5 scoped tools, with reading, writing and deleting kept as three separate, explicitly-authorized surfaces instead of one tool that can do all three.
> Türkçe: README.tr.md
"What did I spend the most on last month?"
"Find uncategorised transactions from August and suggest categories."
"Show me subscriptions whose amount went up."
Everyone runs this against their own Firefly instance with their own token — there is no hosted backend or relay in between.
Listed in the official MCP Registry as io.github.YakupEmreYerli/mcp-firefly-iii, on Glama, and in Firefly III's own third-party apps documentation. Every release is built and published by CI from a tagged commit, with npm provenance attesting that the tarball came from this repository.
## Demo
https://github.com/user-attachments/assets/d308b2b5-18ef-4275-a4ed-ccdb7f04386f
40-second demo: month-end in Claude Code. It reads October, finds 35 uncategorised payments, proposes a plan, dry-runs every write, and only writes after you approve, then checks Firefly III again: 0 left. All financial data shown is fabricated.
## Features
5 meta-tools, not 152. firefly_query, firefly_mutate, firefly_destructive, plus firefly_list_operations and firefly_get_schema for discovery — a typed registry maps every Firefly endpoint onto these instead of flooding the model's tool list.
dry_run on every write, returning the exact request — resolved record IDs included — without sending it.
Bulk writes can't run blind. Filter-driven updates require max_matches and refuse an incomplete scan before the first write; multi-split transaction groups are rejected outright rather than risk folding their amounts together.
Read/write/destructive are separately scoped and enforced, not just annotated — over stdio by the Firefly token, over HTTP by OAuth scope or a static token.
Embedded OAuth 2.1 authorization server for Claude web, Claude mobile, and ChatGPT — no separate Keycloak or Authentik install.
Docker images for linux/amd64/linux/arm64, and a self-checking documentation pipeline that keeps the tool catalogue in sync with the code.
It tells you when it is out of date. Once a day it checks whether a newer version exists and, if so, says so once — a line on stderr, a sentence beside the next answer. MCP_UPDATE_CHECK=false turns it off.
## Prerequisites
A running Firefly III instance and a Personal Access Token (Firefly III → Options → Profile → OAuth → Create New Personal Access Token)
Node.js 20.6+, unless you're using Docker
## Usage
| Method | Transport | Best for |
| npx — stdio | stdio | Claude Code, Claude Desktop, Cursor — simplest setup |
| Static token | HTTP | n8n, automation, headless callers |
| OAuth | HTTP + OAuth | Claude web, Claude mobile, ChatGPT — can't hold a static token |
| Docker | HTTP | Self-hosted, either auth mode above |
### 1. stdio (Claude Code, Claude Desktop, Cursor)
One click: Claude Desktop — download firefly-mcp- .mcpb from the latest release and open it; Claude Desktop asks for your Firefly III URL and token and keeps the token in the system keychain. Cursor — the button installs the server with your-firefly.example and your-token as placeholders; replace them in Cursor's MCP settings. VS Code — the button asks for the URL and the token when the server first starts.
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/zh/s/yakupemreyerli-mcp-firefly-iii/)
来源
awesome · https://github.com/YakupEmreYerli/mcp-firefly-iii
按领域浏览
MCP 服务
Traction
4 ★
收录来源
3 个独立来源
收录于
今天

更多 MCP 服务器

全部 6,555 →

所属领域与标签

每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。

浏览全部领域 →

← 返回索引