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.