预算数据交互服务

YNAB MCP Server是一个用于与YNAB(You Need A Budget)交互的模型上下文协议(MCP)服务器,提供通过MCP客户端访问预算数据的工具。

  • by EthanKang1
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 EthanKang1/ynab-mcp

使用说明

YNAB MCP服务器

用于与YNAB交互的模型上下文协议(MCP)服务器(您需要预算)。提供通过启用MCP的客户端(如Claude Desktop)访问预算数据的工具。

MCP客户端配置

基本配置

将此添加到MCP客户端的配置中(例如。 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检查器进行调试:

  1. 安装检查器:
npm install -g @modelcontextprotocol/inspector
  1. 更新配置以使用带有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": []
    }
  }
}

检查员提供:

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

可用工具

GetUser

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

列表预算

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

GetBudget

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

注:货币金额以毫单位返回(例如,1000=1.00美元)

获取预算类别

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

获取预算设置

检索指定预算的设置,包括货币格式、日期格式和其他首选项。