聚会 MCP 服务器

用于管理聚会和费用分摊的模型上下文协议服务器。

这是一个基于 TypeScript 的 MCP 服务器，可帮助跟踪社交活动的费用和付款，从而轻松计算报销并结算朋友之间的余额。

建筑笔记

重要提示：本项目使用 Node.js 应用程序的非标准架构。TypeScript MCP 服务器充当 Python 后端实现的包装器。Node.js 服务器接收 MCP 请求，将其转换为对 Python 脚本的命令行调用，并返回结果。

虽然这种架构可以满足我们当前的需求，但对于生产应用程序来说，它并不是最有效或最可维护的方法。

待办事项

重构实现以使用更标准的架构：
- 要么将后端完全迁移到 TypeScript/JavaScript
- 或者在 Node.js 和 Python 组件之间实现适当的进程间通信
- 或者用 REST API 方法替换，其中 Python 后端提供 MCP 服务器使用的 API
改进 Node.js 和 Python 组件之间的错误处理
添加组件之间集成的自动化测试
优化 Dockerfile

Related MCP server: Paddle MCP Server

特征

工具

create_gathering - 创建一个新的聚会
- 将gathering_id和members作为必需参数
add_expense - 为会员添加费用
- 将gathering_id 、 member_name和amount作为必需参数
calculate_reimbursements聚会的报销金额
- 将gathering_id作为必需参数
record_payment - 记录会员的付款
- 将gathering_id 、 member_name和amount作为必需参数
rename_member - 重命名未命名的成员
- 将gathering_id 、 old_name和new_name作为必需参数
show_gathering - 显示聚会的详细信息
- 将gathering_id作为必需参数
list_gatherings - 列出所有聚会
close_gathering - 结束聚会
- 将gathering_id作为必需参数
delete_gathering - 删除聚会
- 将gathering_id作为必需参数， force参数为可选参数
add_member - 向聚会添加新成员
- 将gathering_id和member_name作为必需参数
remove_member - 从聚会中删除成员
- 将gathering_id和member_name作为必需参数

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

安装

配置

要与 Claude Desktop 一起使用，请添加服务器配置：

{
  "mcpServers": {
    "gatherings": {
      "command": "node",
      "args": ["/path/to/gatherings-server/build/index.js"],
      "env": {
        "GATHERINGS_DB_PATH": "gatherings.db",
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py"
      },
      "disabled": false,
      "autoApprove": [],
      "alwaysAllow": [
        "create_gathering",
        "add_expense",
        "calculate_reimbursements",
        "record_payment",
        "rename_member", 
        "show_gathering",
        "list_gatherings",
        "close_gathering",
        "delete_gathering",
        "add_member",
        "remove_member"
      ],
      "timeout": 300
    }
  }
}

配置选项

command和args ：指定如何运行服务器
env ：环境变量
- GATHERINGS_DB_PATH ：数据库文件的路径
- GATHERINGS_SCRIPT ：用于处理收集操作的 Python 脚本的路径
alwaysAllow ：无需提示即可自动允许的工具列表
timeout ：最大执行时间（秒）