Gatherings MCP Server

@abutbul

代码仓库

基本信息

分类

其他

许可证

Apache-2.0

传输方式

stdio

作者

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

Gatherings MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Gatherings MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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.

Are there any known limits or restrictions?

A member can only be removed if they have no expenses. The `delete_gathering` command requires `force=True` for closed gatherings.

其他分类下的更多 MCP 服务器

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K