Ynab MCP

🚀 YNAB MCP Server

这是一个用于与“你需要一个预算”（YNAB）无缝集成的模型上下文协议（MCP）服务器。该服务器使人工智能助手能够与你的YNAB预算进行交互，提供强大的自动化和分析功能。

🚀 快速开始

快速安装（Claude桌面端）

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here",
      }
    }
  }
}

可选环境变量：

"env": {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

✨ 主要特性

• 全面的预算管理

  • 查看和管理多个预算
  • 跟踪账户余额和交易
  • 监控类别支出和目标

• 交易控制

  • 列出和搜索交易
  • 更新交易细节
  • 管理收款人和类别

• 财务分析

  • 获取全面的财务概况
  • 跟踪消费模式
  • 监控预算进度

📦 安装指南

使用uvx时无需安装

# 直接运行（推荐）
uvx ynab-mcp-server

# 或者使用特定版本
uvx ynab-mcp-server@0.1.1

开发环境

# 从源代码克隆并运行
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

📚 详细文档

特定平台设置

Claude桌面端

1. 找到你的配置文件：
   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
2. 添加YNAB MCP服务器配置：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

可选环境变量：

env: {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Goose

1. 打开Goose设置
2. 导航到MCP服务器部分
3. 添加一个新服务器，设置如下：
   • 名称：ynab-mcp
   • 命令：uvx ynab-mcp-server
   • 环境变量：
     • YNAB_PAT: your_token_here

其他平台

对于其他支持MCP的平台，使用以下参数进行配置：

• 服务器名称：ynab-mcp
• 命令：uvx
• 参数：ynab-mcp-server
• 必需环境变量：YNAB_PAT

配置

你的服务器可以使用环境变量进行配置。你可以将这些变量放在项目根目录的.env文件中，或者在你的shell中设置它们。

获取你的YNAB令牌

1. 获取你的YNAB令牌
   • 访问YNAB开发者设置
   • 创建一个新的个人访问令牌
   • 复制令牌值
2. 设置环境变量 创建一个.env文件在你的工作目录中：

YNAB_PAT="your_token_here"
YNAB_DEFAULT_BUDGET_ID="your_budget_id"
YNAB_READ_ONLY="true"

或者直接设置环境变量：

export YNAB_PAT="your_token_here"

可用工具

服务器提供了一套与你的YNAB数据进行交互的工具。以下描述解释了每个工具的用途和推荐用法。

开发

本地设置

1. 克隆仓库：

git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server

2. 安装依赖：

uv sync

3. 运行服务器：

uv run ynab-mcp-server

调试

使用MCP检查器进行调试：

npx @modelcontextprotocol/inspector uvx ynab-mcp-server

对于本地开发调试：

cd path/to/ynab-mcp-server
npx @modelcontextprotocol/inspector uv run ynab-mcp-server

你还可以查看日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

构建和发布

# 构建包
uv build

# 发布到PyPI
uv publish

贡献代码

欢迎贡献代码！你可以按照以下步骤进行：

1. 分叉仓库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个拉取请求

请确保你的拉取请求：

• 遵循现有的代码风格
• 包含适当的测试
• 根据需要更新文档

📄 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。

致谢

• YNAB API 提供核心功能
• Model Context Protocol 支持AI助手集成