使用说明
加密货币投资组合MCP
用于跟踪和管理加密货币投资组合分配的MCP服务器,使AI代理能够实时查询和优化投资组合策略。
特性
- 投资组合管理:使用实时币安价格添加和跟踪加密货币持有量。
- 价格检索:获取任何币安交易对的当前价格(例如BTC/USDT)。
- 价值历史:生成投资组合价值随时间变化的可视化图表。
- 分析提示:预先构建的投资组合分析提示,包括多样化和风险建议。
- SQLite存储:在本地数据库中持久存储资产。
安装
先决条件
- Python 3.10+
- Git(可选,用于克隆仓库)
- 兼容的MCP客户端(例如。, 克劳德桌面)
设置
-
克隆存储库:
git clone https://github.com/kukapay/crypto-portfolio-mcp.git cd crypto-portfolio-mcp -
安装要求:
pip install mcp[cli] ccxt matplotlib -
为Claude Desktop安装:
mcp install main.py --name "CryptoPortfolioMCP"或者手动更新配置文件:
{ "mcpServers": { "crypto-portfolio-mcp": { "command": "python", "args": [ "path/to/crypto-portfolio-mcp/main.py" ] } } }
用法
安装后,通过像Claude Desktop这样的MCP客户端与服务器交互。以下是示例命令:
添加控股
- 提示:“将0.1 BTC添加到我的投资组合中”
- 结果:将0.1 BTC/USDT添加到您的投资组合中,并确认“已将0.1 BTC/USDT添加到投资组合中”。
获取当前价格
- 提示:“币安上ETH的当前价格是多少?”
- 结果:返回“币安ETH/USDT的当前价格:$2000.50”(示例价格)。
投资组合摘要
- 提示:“我目前的投资组合摘要是什么?”
- 结果:显示格式化摘要,例如:
Portfolio Summary: BTC/USDT: 0.1 @ $60000.00 = $6000.00 ETH/USDT: 2.0 @ $2000.00 = $4000.00 Total Value: $10000.00
投资组合价值历史
- 提示:“显示我的投资组合价值历史记录”
- 结果:生成并显示您的投资组合价值随时间变化的PNG图表。
分析投资组合
- 提示:“分析我的加密货币投资组合”
- 结果:根据当前持有量和币安市场趋势提供分析和建议。
工具
服务器公开了以下工具:
get_portfolio_summary:检索当前作品集的文本摘要。add_holding(coin_symbol: str, amount: float):添加加密货币持有量(例如,“BTC”,0.1)。get_price(coin_symbol: str):从币安获取交易对的当前价格。portfolio_value_history():生成投资组合价值历史的PNG图表。
有关详细的参数说明,请参阅源代码文档字符串。
数据库
控股权存储在SQLite数据库中(portfolio.db)具有以下模式:
CREATE TABLE holdings (
id INTEGER PRIMARY KEY,
coin_symbol TEXT, -- e.g., "BTC/USDT"
amount REAL, -- Quantity of the asset
purchase_date TEXT -- ISO format timestamp
)
许可证
该项目根据MIT许可证获得许可。看 许可证 了解详情。