Integration · MODEL CONTEXT PROTOCOL

abutbul gatherings mcp python

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 split among participants.

WHAT IT CONNECTS

abutbul gatherings mcp python 为 AI Agent 提供什么

  • 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 members from gatherings
  • Rename members as needed
  • Python 3.8+
  • SQLAlchemy
  • MCP SDK
  • Clone this repository:
  • Install the required dependencies:
  • Set environment variables (optional):
  • Create a gathering for a dinner with 5 friends:
  • Add expenses as people pay for things:
  • Calculate reimbursements:
  • Record payments as people settle up:
  • Close the gathering when all payments are settled:
  • **MCP Server Interface** (`gatherings_mcp_server.py`): Provides the MCP protocol interface that AI tools can interact with.
  • **Service Layer** (`services.py`): Contains business logic for managing gatherings, expenses, and payments.
  • **Data Layer** (`models.py`): Defines the database schema using SQLAlchemy ORM and handles data persistence.
  • **Gathering**: Represents a social event with expenses to split
  • **Member**: A participant in a gathering
  • **Expense**: Money spent by a member for the gathering
  • **Payment**: Money paid by a member to settle balances

SECURITY

MCP 收录不等于安全审核

MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前,请检查代码、环境变量、网络行为、软件包来源与维护状态。