加密货币投资组合 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 客户端与服务器交互。以下是示例命令：

添加持有量

• 提示："Add 0.1 BTC to my portfolio" (向我的投资组合添加 0.1 BTC)
• 结果：将 0.1 BTC/USDT 添加到您的投资组合，并确认 "Added 0.1 BTC/USDT to portfolio"（已将 0.1 BTC/USDT 添加到投资组合）。

获取当前价格

• 提示："What's the current price of ETH on Binance?" (Binance 上 ETH 的当前价格是多少？)
• 结果：返回 "Current price of ETH/USDT on Binance: $2000.50"（Binance 上 ETH/USDT 的当前价格：$2000.50）（示例价格）。

投资组合摘要

• 提示："What's my current portfolio summary?" (我的当前投资组合摘要是什么？)
• 结果：显示格式化的摘要，例如：

  Portfolio Summary:
  BTC/USDT: 0.1 @ $60000.00 = $6000.00
  ETH/USDT: 2.0 @ $2000.00 = $4000.00
  Total Value: $10000.00
  

投资组合价值历史

• 提示："Show me my portfolio value history" (显示我的投资组合价值历史)
• 结果：生成并显示您的投资组合价值随时间变化的 PNG 图表。

分析投资组合

• 提示："Analyze my crypto portfolio" (分析我的加密货币投资组合)
• 结果：根据当前的持有量和 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,       -- e.g., "BTC/USDT"
    amount REAL,           -- Quantity of the asset
    purchase_date TEXT     -- ISO format timestamp
)

许可证

该项目已获得 MIT 许可证的许可。 有关详细信息，请参见 LICENSE。