技术文档摘要

YNAB MCP 服务器

这是一个用于与YNAB（你需要预算）交互的模型上下文协议（MCP）服务器。提供了通过MCP启用的客户端（如Claude Desktop）访问预算数据的工具。

MCP 客户端配置

基本配置

在你的MCP客户端配置中添加以下内容（例如Claude Desktop中的cline_mcp_settings.json）：

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

高级配置

如果你从特定目录运行：

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

调试

使用MCP Inspector进行调试：

1. 安装Inspector：

npm install -g @modelcontextprotocol/inspector

2. 更新配置以使用Inspector与uv：

{
  "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": []
    }
  }
}

Inspector提供：

• 工具调用和响应的实时日志
• 请求/响应检查
• 工具模式验证
• 交互式测试界面

可用工具

GetUser

检索有关已认证YNAB用户的详细信息，包括用户ID和电子邮件地址。

ListBudgets

列出所有可被已认证用户访问的预算，包括预算ID和名称。

GetBudget

检索关于特定预算的详细信息，包括交易、类别和余额。支持可选日期过滤和交易限制。

注意：货币金额以毫单位返回（例如，1000 = $1.00）

GetBudgetCategories

检索指定预算中定义的所有类别，包括类别组、名称和ID。

GetBudgetSettings

检索指定预算的设置，包括货币格式、日期格式和其他偏好设置。