Crypto Portfolio MCP

🚀 暗号通貨ポートフォリオ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" ]
       }
     }
   }
   

💻 使用例

インストールが完了したら、MCPクライアント（Claude Desktopなど）を使用してサーバーとやり取りします。以下はサンプルコマンドです。

基本的な使用法

保有量の追加

# 「0.1 BTCを私のポートフォリオに追加して」と入力すると、0.1 BTC/USDTがポートフォリオに追加され、「0.1 BTC/USDTが追加されました」と確認されます。

現在の価格の取得

# 「BinanceでのETHの現在の価格はいくらですか？」と入力すると、「BinanceでのBTC/USDTの現在の価格は$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の下でライセンスされています。