预算管理服务器

YNAB MCP服务器

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

快速安装（克劳德桌面版）

{
  "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:

# Run directly (recommended)
uvx ynab-mcp-server

# Or with specific version
uvx ynab-mcp-server@0.1.1

发展：

# Clone and run from source
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

平台特定设置

克劳德桌面

1. 找到您的配置文件：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • 视窗: %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"
}

鹅

1. 打开鹅设置
2. 导航到MCP服务器部分
3. 使用以下命令添加新服务器：
   • 姓名： ynab-mcp
   • 命令： uvx ynab-mcp-server
   • 环境变量：
     • YNAB_PAT：您的留言在此

其他平台

对于其他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

建筑与出版

# Build package
uv build

# Publish to 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. 打开拉取请求

请确保您的PR：

• 遵循现有代码样式
• 包括适当的测试
• 根据需要更新文档

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• YNAB API公司 用于提供核心功能
• 模型上下文协议 用于实现AI助手集成