Crypto Portfolio MCP

Crypto Portfolio 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）に保存されます：

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 の下でライセンスされています。詳細は LICENSE を参照してください。