테스트 원격 MCP 서버 - 지출 추적기

카테고리 지원 및 상세 추적 기능을 갖춘 지출 관리용 FastMCP 기반 원격 서버입니다.

개요

이 프로젝트는 지출 추적기 서비스를 위한 MCP(Model Context Protocol) 구현을 제공합니다. FastMCP를 사용하여 Claude Desktop 또는 기타 MCP 호환 클라이언트와 통합할 수 있는 지출 관리 도구를 제공합니다.

Related MCP server: Expense Tracker MCP Server

기능

• 지출 추가: 날짜, 금액, 카테고리, 메모와 함께 새로운 지출 항목 기록

• 카테고리 지원: 카테고리 및 하위 카테고리별로 지출 정리

• 데이터베이스 지속성: 안정적인 데이터 저장을 위한 SQLite 데이터베이스

• 비동기 작업: 효율적인 동시 작업을 위해 async/await로 구축

• 프록시 서버: 원격 액세스를 위한 프록시 서버 구성 포함

프로젝트 구조

test-remote-mcp-server/
├── main.py              # Main FastMCP server with expense tracking tools
├── proxy.py             # Proxy configuration for remote server access
├── categories.json      # Category definitions for expenses
├── pyproject.toml       # Project configuration and dependencies
└── README.md            # This file

설치

사전 요구 사항

• Python 3.11 이상

• pip 또는 Poetry 패키지 관리자

설정

1. 저장소 복제:

git clone https://github.com/deepakbishnoi717/test-remote-mcp-server.git
cd test-remote-mcp-server

2. 가상 환경 생성:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. 의존성 설치:

pip install -e .

또는 Poetry 사용:

poetry install

사용법

로컬 서버 실행

로컬 FastMCP 서버 시작:

python main.py

프록시 서버 사용

원격 FastMCP Cloud 인스턴스에 연결되는 프록시 서버를 실행하려면:

python proxy.py

사용 가능한 도구

add_expense

데이터베이스에 새로운 지출 항목을 추가합니다.

매개변수:

• date (문자열): 지출 날짜 (예: "2024-01-15")

• amount (부동 소수점): 지출 금액

• category (문자열): 주요 지출 카테고리

• subcategory (문자열, 선택 사항): 지출 하위 카테고리

• note (문자열, 선택 사항): 지출에 대한 추가 메모

예시:

await add_expense("2024-01-15", 25.50, "Food", "Groceries", "Weekly shopping")

데이터베이스

이 프로젝트는 데이터 지속성을 위해 SQLite를 사용합니다. 데이터베이스는 첫 실행 시 자동으로 초기화되며 다음을 포함합니다:

• 자동 테이블 생성

• 더 나은 동시성을 위한 WAL(Write-Ahead Logging)

• 지출 정리를 위한 카테고리 테이블 매핑

데이터베이스 파일 위치: 시스템 임시 디렉토리 (expenses.db)

기술 스택

• FastMCP: Model Context Protocol 프레임워크

• aiosqlite: 비동기 SQLite 드라이버

• Python 3.11+: 비동기 지원을 포함한 최신 Python

구성

카테고리

지출 카테고리는 categories.json에 정의되어 있습니다. 이 파일을 사용자 정의하여 사용 사례에 맞는 지출 카테고리를 추가하거나 수정하십시오.

Claude Desktop과의 통합

Claude Desktop에서 이 서버를 사용하려면:

1. 위의 설치 단계에 따라 서버를 설정합니다.

2. 이 MCP 서버에 연결하도록 Claude Desktop을 구성합니다.

3. 자연어 쿼리를 사용하여 지출을 관리합니다.

라이선스

이 프로젝트는 오픈 소스이며 적절한 라이선스 하에 제공됩니다.

기여

기여를 환영합니다! 풀 리퀘스트를 제출하거나 이슈를 열어주세요.

지원

문제나 질문이 있는 경우 GitHub에서 이슈를 열어주세요: https://github.com/deepakbishnoi717/test-remote-mcp-server/issues