모임 MCP 서버
모임과 비용 공유를 관리하기 위한 모델 컨텍스트 프로토콜 서버입니다.
종속성 관리
이 프로젝트에서는 Python 종속성 관리를 위해 pip 대신 uv 사용합니다. Model Context Protocol Python SDK 의 종속성 요구 사항으로 인해 이러한 변경이 필요했습니다.
uv 설치되어 있는지 확인하거나 pip를 통해 설치하세요.
지엑스피1
프로젝트 종속성을 설치하려면:
Related MCP server: Gatherings MCP Server
개요
Gatherings MCP 서버는 AI 비서가 Machine Conversation Protocol을 통해 Gatherings 애플리케이션과 상호 작용할 수 있도록 API를 제공합니다. 이를 통해 AI 시스템은 사용자가 사교 행사, 외출 또는 참가자 간에 비용을 분담하는 모든 모임의 공동 경비를 관리할 수 있도록 지원합니다.
특징
여러 멤버가 참여하는 모임을 만들고 관리하세요
특정 회원에 대한 비용 추가
공정한 상환금을 계산하세요
기록적인 지불 및 상환
자세한 지불 요약 생성
모임에 멤버 추가/제거
필요에 따라 멤버 이름을 바꾸세요
설치
필수 조건
파이썬 3.8 이상
SQLAlchemy
MCP SDK
설정
이 저장소를 복제하세요:
git clone https://your-repository.git cd accel필요한 종속성을 설치하세요:
pip install -r requirements.txt환경 변수 설정(선택 사항):
# Custom database location export GATHERINGS_DB_PATH=path/to/database.db # Custom script location export GATHERINGS_SCRIPT=path/to/gatherings.py
용법
MCP 서버를 시작합니다.
서버는 stdio에서 실행되므로 MCP 프로토콜 클라이언트와 호환됩니다.
API 참조
MCP 서버는 다음 도구를 제공합니다.
create_gathering(gathering_id: str, members: int)
지정된 수의 멤버로 새로운 모임을 만듭니다.
add_expense(gathering_id: str, member_name: str, amount: float)
모임에 참여한 구성원의 비용을 추가합니다.
calculate_reimbursements(gathering_id: str)
모임에서 누가 누구에게 얼마를 빚졌는지 계산합니다.
record_payment(gathering_id: str, member_name: str, amount: float)
회원이 지불한 금액(양수 값) 또는 회원에게 환불된 금액(음수 값)을 기록합니다.
rename_member(gathering_id: str, old_name: str, new_name: str)
모임에서 멤버의 이름을 변경합니다.
show_gathering(gathering_id: str)
비용과 지불 상태를 포함한 모임 세부 정보를 표시합니다.
list_gatherings()
데이터베이스에 있는 모든 모임을 나열합니다.
close_gathering(gathering_id: str)
모임을 종료로 표시하세요.
delete_gathering(gathering_id: str, force: bool = False)
모임과 관련 데이터를 모두 삭제합니다. 종료된 모임을 삭제하려면 force=True 설정합니다.
add_member(gathering_id: str, member_name: str)
기존 모임에 새로운 멤버를 추가합니다.
remove_member(gathering_id: str, member_name: str)
모임에서 구성원을 제외합니다(비용이 없는 경우에만 해당).
예시 흐름
친구 5명과 함께 저녁 식사 모임을 만들어 보세요.
create_gathering("2023-10-15-dinner", 5)사람들이 물건값을 지불할 때 비용을 추가합니다.
add_expense("2023-10-15-dinner", "Alice", 120.50) add_expense("2023-10-15-dinner", "Bob", 35.00)환불금 계산:
calculate_reimbursements("2023-10-15-dinner")사람들이 정착함에 따라 기록적인 지불이 이루어짐:
record_payment("2023-10-15-dinner", "Charlie", 31.10)모든 지불이 완료되면 모임을 종료합니다.
close_gathering("2023-10-15-dinner")
건축학
Gatherings MCP 서버는 세 가지 주요 구성 요소로 구성됩니다.
MCP 서버 인터페이스 (
gatherings_mcp_server.py): AI 도구가 상호 작용할 수 있는 MCP 프로토콜 인터페이스를 제공합니다.서비스 계층 (
services.py): 모임, 비용, 지불을 관리하기 위한 비즈니스 로직을 포함합니다.데이터 계층 (
models.py): SQLAlchemy ORM을 사용하여 데이터베이스 스키마를 정의하고 데이터 지속성을 처리합니다.
데이터 모델
모임 : 비용을 나누어야 하는 사회적 행사를 나타냅니다.
회원 : 모임에 참여하는 사람
비용 : 회원이 모임을 위해 지출한 비용
지불 : 회원이 잔액을 정산하기 위해 지불하는 금액
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.