加密货币投资组合管理服务

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

  • by kukapay
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 kukapay/crypto-portfolio-mcp

使用说明

加密货币投资组合MCP

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

特性

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

安装

先决条件

  • Python 3.10+
  • Git(可选,用于克隆仓库)
  • 兼容的MCP客户端(例如。, 克劳德桌面)

设置

  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添加到投资组合中”。

获取当前价格

  • 提示:“币安上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许可证获得许可。看 许可证 了解详情。