AI导哈

费用管理协议服务器

Splitwise MCP服务器是一个支持自然语言交互的费用管理协议服务器，提供完整的API访问、自然语言解析和智能缓存功能。

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

使用说明

拆分MCP服务器

一种模型上下文协议（MCP）服务器 分行，使AI代理能够用自然语言管理费用、群组和朋友。

特性

  • API完全访问：管理费用、群组、朋友和评论。
  • 自然语言分辨率：名称（“John”->“John Smith”）和组的模糊匹配。
  • 双重身份验证：同时支持OAuth 2.0（推荐）和API密钥。
  • 智能缓存：优化类别和货币等静态数据的性能。

安装

# From PyPI (when published)
pip install splitwise-mcp-server

# From Source
git clone https://github.com/tarunn2799/splitwise-mcp-server
cd splitwise-mcp-server
pip install -e .

配置

看 设置.md 有关详细的身份验证和配置说明。

快速配置

运行附带的安装脚本：

python -m splitwise_mcp_server.oauth_setup

使用那里提供的密钥，并将所有三个添加到您的 mcp.json:

{
  "mcpServers": {
    "splitwise": {
      "command": "python",
      "args": ["-m", "splitwise_mcp_server"],
      "env": {
        "SPLITWISE_OAUTH_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

获取您的身份验证密钥 您可以通过在以下网址注册应用程序来获取您的消费者密钥和密码 https://secure.splitwise.com/apps.

重要： 使用虚拟环境？ 如果您将该软件包安装在 venv 或Conda环境，您必须使用 绝对路径 转到配置中的python可执行文件。

"command": "/absolute/path/to/venv/bin/python"

看 设置.md 了解详情。

用法

服务器支持与Splitwise数据的自然语言交互。

示例：

  • “我目前的余额是多少？”
  • “和莎拉分一份50美元的晚餐。”
  • “用我上传的收据把晚餐分给马纳夫和我。”
  • “给我看看上个月的开支。”
  • “和迈克一起创建一个名为‘滑雪之旅’的小组。”

工具

看 TOOLS.md 详细文档。

用户工具

  • get-current-user：获取经过身份验证的用户信息
  • get-user：获取特定用户的信息

支出工具

  • create-expense：通过拆分创建新的支出
  • get-expenses：使用可选筛选器列出费用
  • get-expense：获取详细的费用信息
  • update-expense：更新现有支出
  • delete-expense：删除费用

组工具

  • get-groups：列出所有组
  • get-group：获取详细的组信息
  • create-group：创建新组
  • delete-group：删除组
  • add-user-to-group：将用户添加到组
  • remove-user-from-group：从组中删除用户

好友工具

  • get-friends：列出所有好友
  • get-friend：获取详细的好友信息

分辨率工具

  • resolve-friend：模糊匹配好友名称和用户ID
  • resolve-group：将组名与组ID模糊匹配
  • resolve-category：将类别名称与类别ID模糊匹配

评论工具

  • create-comment：在费用中添加注释
  • get-comments：获取所有评论以获得费用
  • delete-comment：删除评论

实用工具

  • get-categories：获取所有费用类别
  • get-currencies：获取所有支持的货币

算术工具

  • add：添加多个数字
  • subtract：减去数字
  • multiply：将数字相乘
  • divide：分割数字
  • modulo：计算余数

发展

# Setup
git clone https://github.com/tarunn2799/splitwise-mcp-server
cd splitwise-mcp-server
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

# Test
pytest

许可证

MIT许可证。看 许可证 了解详情。

相关 MCP