Investment Portfolio Manager

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

このサーバーは、Model Context Protocol (MCP) を使用して、投資ポートフォリオの管理と分析に必要なツールとリソースを提供します。

🚀 クイックスタート

この投資ポートフォリオ管理 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 に接続されたら、自然言語で次のようなクエリを実行できます：

• "30% の AAPL、20% の MSFT、15% の AMZN、および 35% の米国国債を含む投資ポートフォリオを作成し、ユーザー ID は <User_ID> とします。"
• "私の投資ポートフォリオの最近のパフォーマンスはどうですか？"
• "私の投資ポートフォリオに含まれる株式に関するニュースを表示してください。"
• "現在の投資ポートフォリオの投資アドバイスを生成してください。"
• "現在の資産配分を可視化してください。"

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。