使用说明
Buxfer MCP服务器
MCP服务器 Buxfer 个人理财API。将账户、交易、预算、标签和合并财务报告暴露给任何兼容MCP的AI客户端。
工具
| 工具 | 说明 |
|---|---|
get_accounts |
列出所有有余额的账户 |
get_transactions |
使用过滤器（日期范围、帐户、标签、状态）获取交易 |
get_budgets |
预算状态——限额、已用、剩余 |
get_tags |
所有交易标签 |
financial_report |
合并报告：账户+所有交易+预算+标签+日期范围内的支出摘要 |
设置
# Install dependencies
pip install -r requirements.txt
# Configure credentials
cp .env.example .env
# Edit .env with your Buxfer email and password
# Run locally
python server.py
服务器启动于 http://localhost:8000/sse.
Docker/Coolify
docker build -t buxfer-mcp .
docker run -p 8000:8000 \
-e BUXFER_EMAIL=your@email.com \
-e BUXFER_PASSWORD=your_password \
buxfer-mcp
在Coolify上，设置 BUXFER_EMAIL 和 BUXFER_PASSWORD 作为服务配置中的环境变量。露出端口8000。
MCP客户端配置
添加到您的MCP客户端配置中（例如Claude Desktop、Gemini CLI）：
{
"mcpServers": {
"buxfer": {
"url": "http://localhost:8000/sse"
}
}
}
对于Coolify部署，请替换 localhost:8000 使用您的服务URL。
