MCP YNAB 服务器
MCP 服务器实现通过模型上下文协议提供对 YNAB(您需要预算)功能的访问。
特征
查看账户余额和交易
创建新交易
通过标准化 MCP 资源访问 YNAB 数据
安装
uv pip install -e .
配置
服务器需要 YNAB API 密钥才能运行。您可以从YNAB 开发者设置中获取一个。
API 密钥可以通过以下方式提供:
环境变量:
YNAB_API_KEY=your_api_keyMCP机密管理系统
项目根目录中的
.env文件
用法
运行服务器
# Development mode with hot reload and browser launch
task dev
# Production install for Claude Desktop, Goose, or any other MCP-supported environment
task install
可用资源
ynab://accounts- 列出所有 YNAB 帐户ynab://transactions/{account_id}- 获取特定账户的最近交易
可用工具
create_transaction创建新交易get_account_balance- 获取账户的当前余额
示例用法
# Create a new transaction
result = await create_transaction(
account_id="your_account_id",
amount=42.50, # in dollars
payee_name="Coffee Shop",
category_name="Dining Out",
memo="Morning coffee"
)
# Get account balance
balance = await get_account_balance("your_account_id")
# List accounts
accounts = await ctx.read_resource("ynab://accounts")
# Get recent transactions
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")
发展
# Install dependencies (uses uv)
task deps
# Run all tests including integration tests (you will need a YNAB API key for this)
task test:all
# Generate coverage report
task coverage
# Format and lint code
task fmt # Should add this to Taskfile
项目任务
该项目使用 Taskfile 进行常见操作。关键命令:
task dev # Start dev server with auto-reload
task test # Run unit tests
task coverage # Generate test coverage report
task install # Install production build
task deps # Synchronize dependencies
请参阅Taskfile.yml以了解所有可用任务。
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
通过模型上下文协议提供对 YNAB(您需要预算)功能的访问,允许用户查看账户余额、访问交易数据和创建新交易。
Related MCP Servers
- Asecurity-licenseAqualityAn MCP server that allows users to interact with YNAB data, enabling access to account balances, transactions, and the creation of new transactions through the Model Context Protocol.Last updated -105
- Asecurity-licenseAqualityA Model Context Protocol server that enables AI-powered interaction with YNAB (You Need A Budget) data, allowing users to query their budgets through conversational interfaces.Last updated -11036MIT License
- -security-license-qualityA Model Context Protocol (MCP) server for interacting with YNAB (You Need A Budget). Provides tools for accessing budget data through MCP-enabled clients like Claude Desktop.Last updated -3MIT License