AI导哈

Splitwise MCP 服务器

一个通过自然语言控制Splitwise费用的Python服务器，利用Claude AI实现自动化的费用分摊和结算。

  • by bhvkmuni
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bhvkmuni/splitwise-mcp

使用说明

Splitwise MCP服务器——用简明英语控制Splitwise

“加上45000英镑的晚餐，我付了钱，平分。” 完成。没有应用程序。不要轻敲。没有数学。

我为什么建造这个

我正要和朋友一起去旅行，已经害怕费用追踪了。

你知道怎么回事——有人付晚餐费，有人抢出租车，另一个人支付酒店押金。到第二天，你已经迷失了方向。因此，您打开Splitwise，点击四个屏幕，键入金额，选择人员，选择付款人，点击保存。然后再做下一件事。下一个。

我想： 我已经在用克劳德做其他事情了。如果我能告诉它发生了什么，它能为我处理Splitwise怎么办？

所以我在周末建造了这个。这是一个小型Python服务器，将Claude AI直接连接到您的Splitwise帐户。你像人类一样与克劳德交谈，它会为你完成Splitwise的工作——增加开支、检查余额、记录结算、纠正错误。

无需切换应用程序。无需手动输入。说说发生了什么事。

使用感觉如何

You:    "We had a group dinner for ₩65,000. I paid. Split equally."
Claude: Done! Added "Group dinner" for ₩65,000.00 (KRW), split equally
        among 4 members. Each person owes ₩16,250.

You:    "What does everyone owe in the trip group?"
Claude: Here are the current balances:
        • Raj owes you ₩32,500
        • Priya owes you ₩16,250
        • Sam is owed ₩8,000 by the group

You:    "Record that Raj paid me back ₩30,000."
Claude: Payment of ₩30,000 recorded. Raj's balance updated.

You:    "Wait, that dinner was actually ₩72,000. Can you fix it?"
Claude: Updated! "Group dinner" changed to ₩72,000. Shares recalculated.

适用于Splitwise支持的任何货币——美元、欧元、印度卢比、韩元、日元等。

它是如何工作的（简单版本）

You talk to Claude
       ↓
Claude understands what you want
       ↓
Claude calls this MCP server
       ↓
This server calls the Splitwise API
       ↓
Your Splitwise account updates instantly
       ↓
Everyone's app reflects the change

主控程序 （模型上下文协议）是让Claude访问外部工具的标准方式。这个项目是“Splitwise工具”，是Claude和您的Splitwise帐户之间的桥梁。

看 architecture.md 查看所有事物如何连接的详细图表。

你能做什么

问克劳德 发生了什么事
“列出我的组” 显示所有有成员的拆分组
“[组]中谁欠什么？” 显示所有余额
“加一顿52美元的午餐，我付了，平分” 产生费用
“加上240美元的酒店——我付了120美元，亚历克斯付了80美元，萨姆付了40美元” 确切的分割
“将35美元的出租车分成50/30/20” 分成百分比
“亚历克斯还我20美元的记录” 结算付款
“删除最后一笔费用” 删除它
“将晚餐更改为60美元” 更新并重新计算

设置

你需要什么

  • Python 3.10+(python3 --version 检查）
  • Splitwise帐户+API密钥来自 secure.splitwise.com/apps
  • 克劳德桌面或克劳德代码

步骤1：克隆并安装

git clone https://github.com/yourusername/splitwise-mcp.git
cd splitwise-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

步骤2：添加您的API密钥

创建一个名为的文件 .env 在项目文件夹中：

SPLITWISE_API_KEY=paste_your_key_here

在哪里可以拿到钥匙：

  1. 首选 secure.splitwise.com/apps
  2. 点击“注册您的申请”
  3. 填写任何名称（例如“我的MCP服务器”）
  4. 复制 API密钥 进入你的 .env 文件

步骤3：连接到克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "splitwise": {
      "command": "/full/path/to/venv/bin/python3",
      "args": ["/full/path/to/splitwise_server.py"]
    }
  }
}

重新启动克劳德桌面。您将看到一个锤子图标，这意味着工具已连接。

步骤4（可选）：服务器上的主机可全天候访问

即使你的笔记本电脑关机，它也能运行吗？部署到任何VPS（我使用Hostinger）。

看 部署.md 获取完整的分步指南。

托管后，通过以下方式连接Claude Desktop：

{
  "mcpServers": {
    "splitwise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://YOUR_SERVER_IP:8000/mcp", "--allow-http"]
    }
  }
}

所有可用工具

工具 它做什么
get_current_user 您的Splitwise个人资料
list_currencies Splitwise支持的所有货币
list_groups 所有具有成员ID的组
get_group 集团详细信息——成员、余额、债务
list_expenses 团体最近的支出
get_expense 一项支出的全部细节
create_expense 添加费用（相等、精确或百分比分割）
update_expense 编辑描述、成本、货币或日期
delete_expense 删除费用
create_payment 记录两人之间的和解

故障排除

问题 修复
Claude看不到Splitwise工具 编辑配置后重新启动Claude Desktop
401未经授权的错误 请检查您的API密钥 .env 是正确的
“没有名为mcp的模块” 激活您的venv： source venv/bin/activate
服务器已断开连接 检查服务器是否正在运行： sudo systemctl status splitwise-mcp
配置中的路径错误 使用完整的绝对路径，而不是相对路径

项目结构

splitwise-mcp/
├── splitwise_server.py   ← The entire server (~500 lines, one file)
├── .env                  ← Your API key (never committed to git)
├── requirements.txt      ← Python dependencies
├── architecture.md       ← How everything connects
├── DEPLOY.md             ← How to host on a VPS
└── README.md             ← This file

构建于

由一位首次使用Python的开发人员构建，他只是想停止手动记录旅行费用。如果我能建造它，你就可以使用它。

许可证

麻省理工学院——随心所欲地使用它。

相关 MCP