ynab-mcp

YNAB MCP 服务器

用于与 YNAB（You Need A Budget）交互的模型上下文协议 (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 检查器进行调试：

安装检查器：

npm install -g @modelcontextprotocol/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": []
    }
  }
}

检查员提供：

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

可用工具

获取用户

检索有关经过身份验证的 YNAB 用户的信息，包括用户 ID 和电子邮件。

预算清单

列出经过身份验证的用户可以访问的所有预算，包括预算 ID 和名称。

获取预算

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

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

获取预算类别

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

获取预算设置

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