MCP InvestmentPortfolio

🚀 投資ポートフォリオ管理 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いて、投資ポートフォリオの管理と分析を行うためのツールやリソースを提供します。

✨ 主な機能

• 投資ポートフォリオ管理：株式や債券を含む投資ポートフォリオの作成と更新が可能です。
• 市場データ：リアルタイムの株価情報と関連ニュースを取得できます。
• 分析：包括的な投資ポートフォリオレポートとパフォーマンス分析を生成します。
• 推奨：投資ポートフォリオの構成に基づいた個人化された投資アドバイスを提供します。
• 可視化：投資ポートフォリオの配分を視覚的に表現できます。

📦 インストール

1. このリポジトリをクローンします：

   git clone https://github.com/ikhyunAn/portfolio-manager-mcp.git
   cd portfolio-manager-mcp
   

2. 必要な依存関係をインストールします：

   pip install -r requirements.txt
   

3. API キーを設定します（オプション）：

   export ALPHA_VANTAGE_API_KEY="your_key_here"
   export NEWS_API_KEY="your_key_here"
   

   または、プロジェクトのルートディレクトリに .env ファイルを作成して API キーを保存することもできます。

💻 使用例

基本的な使用法

サーバーの起動

サーバーは 2 つの異なるモードで起動することができます。

1. Stdio 伝送（デフォルト、Claude Desktop との統合に適しています）：

   python main.py   # コマンドは置き換え可能です：i.e.) python3, python3.11
   

2. SSE 伝送（HTTP ベースのクライアントに適しています）：

   python main.py --sse
   

Claude Desktop への統合

サーバーを Claude Desktop の設定ファイルに追加します：

{
  "mcpServers": {
    "portfolio-manager": {
      "command": "python",      // 異なるコマンドを使用する場合があります
      "args": ["/path/to/portfolio-manager-mcp/main.py"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_key_here",
        "NEWS_API_KEY": "your_key_here"
      }
    }
  }
}

仮想環境でサーバーを実行する場合、設定ファイルは次のようになります：

{
  "mcpServers": {
    "portfolio-manager": {
      "command": "/path/to/portfolio-manager-mcp/venv/bin/python",
      "args": ["/path/to/portfolio-manager-mcp/main.py"],
      "env": {
        "PYTHONPATH": "/path/to/portfolio-manager-mcp",
        "ALPHA_VANTAGE_API_KEY": "your_key_here",
        "NEWS_API_KEY": "your_key_here"
      }
    }
  }
}

仮想環境で実行するには：

# 仮想環境を作成します
python3 -m venv venv

# 仮想環境をアクティブ化します
source venv/bin/activate  # macOS/Linux の場合
# または
# venv\Scripts\activate   # Windows の場合

# 依存関係をインストールします
pip install -r requirements.txt

# サーバーを起動します
python3 main.py

または、MCP CLI を使用して簡単にインストールすることもできます：

mcp install main.py

高度な使用法

サンプルクエリ

サーバーが起動し、Claude に接続されたら、以下のサンプルクエリを使用できます。

• 投資ポートフォリオの現在の状態を確認する：portfolio status
• 詳細な財務レポートを取得する：portfolio report
• 投資比率を変更する：portfolio set_allocation equity=60 bond=40
• 新しい金融資産を追加する：portfolio add_asset ticker=TSLA name=特斯拉

📚 ドキュメント

プロジェクト構造

PortfolioManagerMCP/
├── main.py          # メインプログラムのエントリーポイント
├── config/         # 設定ファイルと API キーの保存場所
│   ├── api_keys.json
│   └── settings.yaml
├── portfolio/
│   ├── models/      # 投資ポートフォリオ分析モデル
│   │   └── portfolio_analyzer.py
│   └── views/       # ユーザーインターフェイスコンポーネント
│       └── portfolio_viewer.py
└── utils/           # ユーティリティ関数
    └── data_loader.py

📄 ライセンス

MIT