Splitwise MCP Server

MCP运维云端

提供方 bhvkmuni

运维云端 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaude
查看接入方式

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

一句话选型结论

按资料字段整理

Splitwise MCP Server 属于运维云端类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 10 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量10暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

自然语言处理Python本地部署费用分摊Python服务器Splitwise集成AI自动化

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python3 -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Splitwise MCP Server当前 10 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bhvkmuni上游标注的维护方 bhvkmuni
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

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:克隆并安装```bash

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:```json
{
"mcpServers": {
"splitwise": {
"command": "/full/path/to/venv/bin/python3",
"args": ["/full/path/to/splitwise_server.py"]
}
}
}


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

### 步骤4(可选):服务器上的主机可全天候访问

即使你的笔记本电脑关机,它也能运行吗?部署到任何VPS(我使用Hostinger)。

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

托管后,通过以下方式连接Claude Desktop:```json
{
"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
```


构建于

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

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


许可证

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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Splitwise MCP Server 怎么安装?

在客户端按下面的安装命令接入:python3 -m venv venv。装完在客户端配置里引用同一个包或端点。

Splitwise MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Splitwise MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Splitwise MCP Server 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Splitwise MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Splitwise MCP Server 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 自然语言处理、Python、Claude、AI自动化。具体工具清单以官方文档为准。

Splitwise MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Splitwise MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。