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" ] } } }

使用法

インストールが完了したら、Claude DesktopなどのMCPクライアントを介してサーバーと通信します。以下にコマンド例を示します。

保有を追加する

• プロンプト: 「ポートフォリオに 0.1 BTC を追加します」
• 結果: ポートフォリオに 0.1 BTC/USDT を追加し、「ポートフォリオに 0.1 BTC/USDT を追加しました」と確認します。

現在の価格を取得

• プロンプト: 「Binance での ETH の現在の価格はいくらですか?」
• 結果: 「Binance における 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 チャートを生成し、表示します。

ポートフォリオを分析する

• プロンプト：「私の暗号資産ポートフォリオを分析してください」
• 結果: 現在の保有状況と Binance 市場の動向に基づいた提案を含む分析を提供します。

ツール

サーバーは次のツールを公開します。

• get_portfolio_summary : 現在のポートフォリオのテキスト概要を取得します。
• add_holding(coin_symbol: str, amount: float) : 暗号通貨の保有量を追加します(例: "BTC"、0.1)。
• get_price(coin_symbol: str) : Binance から取引ペアの現在の価格を取得します。
• portfolio_value_history() : ポートフォリオの価値履歴の PNG チャートを生成します。

詳細なパラメータの説明については、ソース コードの docstring を参照してください。

データベース

保有資産は、次のスキーマを持つ SQLite データベース ( portfolio.db ) に保存されます。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はライセンスをご覧ください。