etnperlong/firefly-iii-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

91 stars 24 forks 품질 67 트렌드 15MIT

Repository Install

etnperlong/firefly-iii-mcp는 MCP 서버 후보가 https://github.com/etnperlong/firefly-iii-mcp.에서 수입되었습니다

개요

etnperlong/firefly-iii-mcp는 MCP 서버 후보가 https://github.com/etnperlong/firefly-iii-mcp.에서 수입되었습니다

개요(AI 번역)

이것은 Firefly III의 모델 Context Protocol (MCP) 서버, 무료 및 오픈 소스 개인 금융 관리자입니다. 이 MCP 서버를 통해 사용자는 Firefly III 계정과 거래를 관리하기 위해 AI 도구를 활용할 수 있으며 개인 금융 및 회계를위한 AI 보조를 만들 수 있습니다.

*자료실

프로젝트 구조

이 프로젝트는 다음 주요 패키지를 포함하는 Turborepo-managed monorepo 구조를 사용합니다.

@firefly-iii-mcp/core - Firefly III API와 상호 작용하는 기반을 제공하는 핵심 기능 모듈
@firefly-iii-mcp/local - MCP 서버를 로컬로 실행하는 명령줄 도구
@firefly-iii-mcp/cloudflare-worker - 배포용 구현 Cloudflare Workers
@firefly-iii-mcp/server - Streamable HTTP 및 SSE 지원과 Express 기반 서버 구현

특징

AI를 통해 Firefly III 인스턴스와 상호 작용
Programmatically 계정 및 거래 관리
다양한 금융 운영을 위한 Extensible Toolet
로컬 및 클라우드 배포 지원
모형 Context 의정서 기준에 호환이 되는
토큰 사용을 줄이기 위해 미리 설정 또는 사용자 정의 태그를 통해 필터링

필수품

Firefly III 인스턴스 실행

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Firefly III MCP Server

This is a Model Context Protocol (MCP) server for Firefly III, a free and open-source personal finance manager. Through this MCP server, users can leverage AI tools to manage their Firefly III accounts and transactions, creating AI assistants for personal finance and accounting.

查看中文版

Project Structure

This project uses a Turborepo-managed monorepo structure, containing the following main packages:

@firefly-iii-mcp/core - Core functionality module providing the foundation for interacting with the Firefly III API
@firefly-iii-mcp/local - Command-line tool for running the MCP server locally
@firefly-iii-mcp/cloudflare-worker - Implementation for deployment to Cloudflare Workers
@firefly-iii-mcp/server - Express-based server implementation with Streamable HTTP and SSE support

Features

Interact with Firefly III instances via AI
Programmatically manage accounts and transactions
Extensible toolset for various financial operations
Support for both local and cloud deployment
Compatible with the Model Context Protocol standard
Tool filtering via presets or custom tags to reduce token usage

Prerequisites

A running Firefly III instance
A Cloudflare account if you plan to deploy using the “Deploy to Cloudflare” button

Getting Started

1. Obtain a Firefly III Personal Access Token (PAT)

To allow the MCP server to interact with your Firefly III instance, you need to generate a Personal Access Token (PAT):

Log in to your Firefly III instance
Navigate to Options > Profile > OAuth
Under the “Personal access tokens” section, click on “Create new token”
Give your token a descriptive name (e.g., “MCP Server Token”)
Click “Create”
Important: Copy the generated token immediately. You will not be able to see it again.

For more details, refer to the official Firefly III documentation on Personal Access Tokens.

2. Configure the MCP Server

You need to provide the Firefly III PAT and your Firefly III instance URL to the MCP server. This can be done in several ways:

Request Headers (Recommended)

Provide these values in the headers of each request to the MCP server. This is generally the most secure method:

X-Firefly-III-Url: Your Firefly III instance URL (e.g., https://firefly.yourdomain.com)
Authorization: The Personal Access Token, typically prefixed with Bearer (e.g., Bearer YOUR_FIREFLY_III_PAT)

Please consult the documentation of the AI tool or client you are using for the exact header names it expects.

Query Parameters (Use with caution)

Alternatively, you can provide these values in the query parameters of each request to the MCP server:

baseUrl: Your Firefly III instance URL
pat: Your Firefly III Personal Access Token

GitHub에서 전체 README 보기

설치

npx @firefly-iii-mcp/local --pat <Your Firefly III Personal Access Token> --baseUrl <Your Firefly III Base URL> --preset default

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": [
        "@firefly-iii-mcp/local",
        "--pat",
        "<Your Firefly III Personal Access Token>",
        "--baseUrl",
        "<Your Firefly III Base URL>",
        "--preset",
        "default"
      ]
    }
  }
}