Gatherings MCP Python

🚀 聚会 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を用いて、パーティや費用の分担を管理するためのものです。

🚀 クイックスタート

Gatherings MCP サーバーは、AI アシスタントがマシン会話プロトコル（Machine Conversation Protocol）を通じて Gatherings アプリケーションとやり取りできる API を提供します。これにより、AI システムはユーザーが社交活動、外出、またはその他のパーティの共有費用を管理するのを支援できます。

サーバーを起動するには、以下のコマンドを実行します。

python gatherings_mcp_server.py

このサーバーは標準入出力で動作し、MCP プロトコルクライアントと互換性があります。

✨ 主な機能

• 複数のメンバーを持つパーティを作成および管理する
• 特定のメンバーに費用を追加する
• 公平な返金を計算する
• 支払いと返金を記録する
• 詳細な支払い摘要を生成する
• パーティメンバーを追加/削除する
• いつでもメンバーの名前を変更する

📦 インストール

前提条件

• Python 3.8 以上
• SQLAlchemy
• MCP SDK

セットアップ

1. このリポジトリをクローンします。

   git clone https://your-repository.git
   cd accel
   

2. 必要な依存関係をインストールします。

   pip install -r requirements.txt
   

3. 環境変数を設定します（オプション）。

   # データベースの場所をカスタマイズする
   export GATHERINGS_DB_PATH=path/to/database.db
   
   # スクリプトの場所をカスタマイズする
   export GATHERINGS_SCRIPT=path/to/gatherings.py
   

💻 使用例

基本的な使用法

サーバーを起動するコマンドは以下の通りです。

python gatherings_mcp_server.py

📚 ドキュメント

API リファレンス

MCP サーバーは以下のツールを公開しています。

create_gathering(gathering_id: str, members: int)

指定されたメンバー数の新しいパーティを作成します。

add_expense(gathering_id: str, member_name: str, amount: float)

パーティの特定のメンバーに費用を追加します。

calculate_reimbursement(gathering_id: str)

パーティの返金額を計算します。

record_payment(gathering_id: str, payer: str, amount: float)

あるメンバーの支払いを記録します。

generate_summary(gathering_id: str)

パーティの支払い摘要を生成します。

add_member(gathering_id: str, member_name: str)

パーティに新しいメンバーを追加します。

remove_member(gathering_id: str, member_name: str)

パーティから指定されたメンバーを削除します。

rename_member(gathering_id: str, old_name: str, new_name: str)

パーティのメンバーの名前を変更します。

🔧 技術詳細

このプロジェクトでは、Python の依存関係管理に uv を使用しています。これは、モデルコンテキストプロトコル Python SDK の依存関係要件によるものです。

uv がインストールされていない場合は、以下のコマンドでインストールできます。

pip install uv

プロジェクトの依存関係をインストールするには、以下のコマンドを実行します。

uv pip install -r requirements.txt