Crypto Portfolio MCP

🚀 加密貨幣投資組合 MCP 服務器

加密貨幣投資組合 MCP 服務器可用於跟蹤和管理加密貨幣投資組合分配，支持 AI 代理即時查詢並優化投資組合策略。

🚀 快速開始

加密貨幣投資組合 MCP 服務器能助力你高效管理加密貨幣投資組合。你可按以下步驟進行安裝和使用。

✨ 主要特性

• 投資組合管理：添加並跟蹤加密貨幣持倉，結合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" ]
       }
     }
   }
   

💻 使用示例

安裝完成後，通過MCP客戶端（如Claude Desktop）與服務器交互。以下是示例命令：

基礎用法

添加持倉

• 提示： "將0.1 BTC添加到我的投資組合中"
• 結果：添加0.1 BTC/USDT到你的投資組合，並確認“已添加0.1 BTC/USDT”。

獲取當前價格

• 提示： "Binance上ETH的當前價格是多少？"
• 結果：返回"BTC/USDT在Binance上的當前價格為$60000.00（示例價格）"。

投資組合摘要

• 提示： "我的當前投資組合摘要是什麼？"
• 結果：顯示格式化的摘要，例如：

  投資組合摘要：
  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()：生成投資組合價值隨時間變化的圖表。

📚 詳細文檔

數據庫

持倉信息將存儲在以下路徑：

/path/to/your/project/crypfolio.db

術語表

示例代碼

添加持倉

# 初始化數據庫連接
conn = sqlite3.connect('crypfolio.db')
cursor = conn.cursor()

# 創建持倉表
cursor.execute('''
    CREATE TABLE IF NOT EXISTS holdings 
    (id INTEGER PRIMARY KEY AUTOINCREMENT,
     coin TEXT,
     amount REAL)
''')

# 插入數據
coin = "BTC"
amount = 0.1
cursor.execute('INSERT INTO holdings (coin, amount) VALUES (?, ?)', (coin, amount))
conn.commit()
conn.close()

獲取當前價格

import ccxt

# 初始化Binance接口
binance = ccxt.binance()

# 獲取BTC/USDT的當前價格
symbol = "BTC/USDT"
ticker = binance.fetch_ticker(symbol)
current_price = ticker['last']
print(f"{symbol} 當前價格為：{current_price}")

項目結構

crypto-portfolio-mcp/
├── main.py          # 主程序入口
├── config.py        # 配置文件
├── holdings.db      # 數據庫文件
└── README.md        # 項目文檔

貢獻指南

歡迎貢獻！請參考CONTRIBUTING.md瞭解如何參與。

📄 許可證

本項目採用MIT License。