Firefly III MCP Server - Cloudflare Worker

이 패키지는 Cloudflare Workers에서 Firefly III MCP(Model Context Protocol) 서버의 구현을 제공합니다. Cloudflare Workers를 사용하면 MCP 서버를 클라우드에 쉽게 배포하고 글로벌 엣지 네트워크의 성능 이점을 누릴 수 있습니다.

중국어 버전 보기

기능

• Cloudflare Workers 기반 글로벌 엣지 배포

• 낮은 지연 시간과 높은 가용성 서비스

• 서버 유지보수 불필요

• Firefly III API와의 원활한 연동

• 프리셋 또는 사용자 정의 태그를 통한 도구 필터링 지원

Related MCP server: Firefly III MCP Server

배포 방법

원클릭 배포

가장 간단한 방법은 "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: 일상적인 사용을 위한 기본 도구 (accounts, bills, categories, tags, transactions, search, summary)

• 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 라이선스에 따라 라이선스가 부여됩니다.