YNAB MCP Server

基本能力

产品定位

YNAB MCP Server 是一个预算管理服务，旨在通过 MCP 协议与 YNAB 进行交互，提供预算数据的访问和管理功能。

核心功能

1. 用户信息获取：获取认证用户的 ID 和邮箱信息。
2. 预算列表：列出所有可访问的预算及其 ID 和名称。
3. 预算详情：获取特定预算的详细信息，包括交易、类别和余额，支持日期过滤和交易限制。
4. 预算类别：获取预算中定义的所有类别，包括类别组、名称和 ID。
5. 预算设置：获取预算的设置信息，包括货币格式、日期格式等偏好设置。

适用场景

1. 个人财务管理：通过 MCP 客户端管理个人预算和交易。
2. 自动化预算分析：通过工具获取预算数据进行分析和报告。
3. 集成开发：将 YNAB 预算管理功能集成到其他应用中。

工具列表

1. GetUser：获取认证用户的 ID 和邮箱信息。
2. ListBudgets：列出所有可访问的预算及其 ID 和名称。
3. GetBudget：获取特定预算的详细信息，包括交易、类别和余额。
4. GetBudgetCategories：获取预算中定义的所有类别。
5. GetBudgetSettings：获取预算的设置信息。

常见问题解答

1. 如何配置 MCP 客户端：需要在 MCP 客户端的配置文件中添加 YNAB MCP Server 的配置信息，包括 API 密钥。
2. 如何调试：可以使用 MCP Inspector 进行调试，安装后更新配置即可。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 安装 MCP Inspector（可选）：

npm install -g @modelcontextprotocol/inspector

安装教程

1. 配置 MCP 客户端（如 Claude Desktop）的 cline_mcp_settings.json 文件：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

1. 如果从特定目录运行，可以使用以下配置：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

调试方式

1. 安装 MCP Inspector：

npm install -g @modelcontextprotocol/inspector

1. 更新配置以使用 Inspector：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

1. Inspector 提供以下功能：
2. 实时日志记录工具调用和响应
3. 请求/响应检查
4. 工具模式验证
5. 交互式测试界面

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。