Gatherings MCP Server

Name: Gatherings MCP Server
Author: abutbul

@abutbul

Gatherings MCP Server について

The Gatherings MCP Server provides an API that allows AI assistants to interact with the Gatherings application through the Machine Conversation Protocol. This enables AI systems to help users manage shared expenses for social events, outings, or any gathering where costs are spl

#gatherings #mcp #expense-sharing #api

基本情報

カテゴリ

その他

ライセンス

Apache-2.0

ランタイム

python

トランスポート

stdio

公開者

abutbul

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "gatherings-mcp-python": {
      "command": "python",
      "args": [
        "gatherings_mcp_server.py"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Gatherings MCP Server?

A Model Context Protocol server that provides an API for AI assistants to interact with the Gatherings application, enabling management of shared expenses for social events where costs are split among participants. It uses SQLAlchemy for data persistence and the MCP Python SDK.

How to use Gatherings MCP Server?

Install dependencies with uv pip install -r requirements.txt or pip install -r requirements.txt, optionally set environment variables GATHERINGS_DB_PATH and GATHERINGS_SCRIPT, then run python gatherings_mcp_server.py. The server communicates over stdio with any MCP client. Tools are invoked by name with parameters (e.g., create_gathering, add_expense, calculate_reimbursements).

Key features of Gatherings MCP Server

Create and manage gatherings with multiple members
Add expenses for specific members
Calculate fair reimbursements
Record payments and reimbursements
Generate detailed payment summaries
Add, remove, and rename members

Use cases of Gatherings MCP Server

Splitting dinner costs among a group of friends
Managing shared expenses for a group outing
Tracking who paid and who owes for a social event

FAQ from Gatherings MCP Server

What dependencies does Gatherings MCP Server require?

Python 3.8+, SQLAlchemy, MCP SDK, and the uv package manager (optional but recommended). Dependencies are listed in requirements.txt.

How does the server persist data?

It uses SQLAlchemy ORM with a database file whose path can be customized via the GATHERINGS_DB_PATH environment variable.

What transport does the server use?

The server communicates over stdio, making it compatible with MCP protocol clients that expect a subprocess.

What tools are available and how do I call them?

Tools include create_gathering, add_expense, calculate_reimbursements, record_payment, rename_member, show_gathering, list_gatherings, close_gathering, delete_gathering, add_member, and remove_member. Each tool expects specific parameters as documented in the API reference.