Splitwise MCP Server

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 查看所有事物如何连接的详细图表。

______________________________________________________________________

你能做什么

______________________________________________________________________

设置

你需要什么

• 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"]
    }
  }
}

______________________________________________________________________

所有可用工具

______________________________________________________________________

故障排除

______________________________________________________________________

项目结构

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

______________________________________________________________________

构建于

• FastMCP --Python MCP框架
• 拆分REST API v3
• httpx --HTTP客户端
• 托管在Hostinger VPS（Ubuntu）上

______________________________________________________________________

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

______________________________________________________________________

许可证

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