Gatherings Mcp Python

金融官方认证 Python

🚀 聚会 MCP 服务器

这是一个用于管理聚会和费用分摊的模型上下文协议（Model Context Protocol）服务器，它能让 AI 系统助力用户管理社交活动、外出或各类聚会的共享费用。

Gatherings MCP 服务器提供了一个 API，允许 AI 助手通过机器对话协议（Machine Conversation Protocol）与 Gatherings 应用程序交互。启动 MCP 服务器的命令如下：

python gatherings_mcp_server.py

该服务器在标准输入输出上运行，使其与 MCP 协议客户端兼容。

克隆此仓库：

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

设置环境变量（可选）：

# 自定义数据库位置
export GATHERINGS_DB_PATH=path/to/database.db

# 自定义脚本位置
export GATHERINGS_SCRIPT=path/to/gatherings.py

启动 MCP 服务器：

python gatherings_mcp_server.py

MCP 服务器公开了以下工具：

API 接口	功能描述
`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)`	重命名聚会中的某个成员。

欢迎贡献！请随意提交 Pull Request。