🚀 聚会 MCP 服务器

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

🚀 快速开始

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

python gatherings_mcp_server.py

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

✨ 主要特性

• 👥 创建和管理具有多个成员的聚会
• 💸 为特定成员添加费用
• 📊 计算公平报销
• 📝 记录支付和报销
• 📄 生成详细的支付摘要
• ➕➖ 添加/移除聚会成员
• ✏️ 随时重命名成员

📦 安装指南

先决条件

• Python 3.8+
• SQLAlchemy
• MCP SDK

设置

1. 克隆此仓库：

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

2. 安装所需的依赖项： 该项目使用 uv 进行 Python 依赖管理，而不是 pip。此更改是由于对 模型上下文协议 Python SDK 的依赖要求。 确保你已经安装了 uv 或者通过以下命令进行安装：

   pip install uv
   

   要安装项目依赖项：

   uv pip install -r requirements.txt
   

3. 设置环境变量（可选）：

   # 自定义数据库位置
   export GATHERINGS_DB_PATH=path/to/database.db
   
   # 自定义脚本位置
   export GATHERINGS_SCRIPT=path/to/gatherings.py
   

💻 使用示例

基础用法

启动 MCP 服务器：

python gatherings_mcp_server.py

📚 详细文档

API 参考

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

🤝 贡献

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