Crypto Portfolio MCP

一个用于跟踪和管理加密货币投资组合分配的MCP服务器，使AI代理能够实时查询并优化投资组合策略。

功能

• 投资组合管理：使用实时Binance价格添加和跟踪加密货币持有量。
• 价格检索：获取任何Binance交易对（例如，BTC/USDT）的当前价格。
• 价值历史：生成投资组合价值随时间变化的可视化图表。
• 分析提示：预构建的投资组合分析提示，包括多元化和风险建议。
• SQLite存储：在本地数据库中持久存储持有量。

安装

先决条件

• Python 3.10+
• Git（可选，用于克隆仓库）
• 兼容的MCP客户端（例如，Claude Desktop）

设置

1. 克隆仓库：

   git clone https://github.com/kukapay/crypto-portfolio-mcp.git
   cd crypto-portfolio-mcp
   

2. 安装依赖项：

   pip install mcp[cli] ccxt matplotlib
   

3. 为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到投资组合”。

获取当前价格

• 提示："Binance上ETH的当前价格是多少？"
• 结果：返回"Binance上ETH/USDT的当前价格：$2000.50"（示例价格）。

投资组合概要

• 提示："我的当前投资组合概要是什么？"
• 结果：显示格式化的概要，例如：

  投资组合概要：
  BTC/USDT: 0.1 @ $60000.00 = $6000.00
  ETH/USDT: 2.0 @ $2000.00 = $4000.00
  总价值：$10000.00
  

投资组合价值历史

• 提示："展示我的投资组合价值历史"
• 结果：生成并显示投资组合价值随时间变化的PNG图表。

分析投资组合

• 提示："分析我的加密货币投资组合"
• 结果：根据当前持有量和Binance市场趋势提供分析及建议。

工具

该服务器暴露了以下工具：

• get_portfolio_summary：获取当前投资组合的文本概要。
• add_holding(coin_symbol: str, amount: float)：添加加密货币持有量（例如，“BTC”，0.1）。
• get_price(coin_symbol: str)：从Binance获取交易对的当前价格。
• portfolio_value_history()：生成投资组合价值历史的PNG图表。

查看源代码中的文档字符串以获取详细的参数描述。

数据库

持有量存储在一个SQLite数据库（portfolio.db）中，其模式如下：

CREATE TABLE holdings (
    id INTEGER PRIMARY KEY,
    coin_symbol TEXT,       -- 例如，“BTC/USDT”
    amount REAL,           -- 资产数量
    purchase_date TEXT     -- ISO格式的时间戳
)

许可证

本项目采用MIT许可证。详情见LICENSE。