Firefly III MCP 서버 - 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

배포 방법

원클릭 배포

가장 간단한 방법은 "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: 일상적인 사용을 위한 기본 도구 (계정, 청구서, 카테고리, 태그, 거래, 검색, 요약)

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