Portfolio Manager MCP Server

ポートフォリオマネージャー 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   # alternate commands: i.e.) python3, python3.11
   

2. SSE トランスポート（HTTP ベースのクライアント用）：

   python main.py --sse
   

Claude Desktop との連携

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

{
  "mcpServers": {
    "portfolio-manager": {
      "command": "python",      // may use different command
      "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"
      }
    }
  }
}

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

# Create a virtual environment
python3 -m venv venv

# Activate the virtual environment
source venv/bin/activate  # On macOS/Linux
# or
# venv\Scripts\activate   # On Windows

# Install dependencies
pip install -r requirements.txt

# Run the server
python3 main.py

または、インストールを簡単にするために MCP CLI を使用します：

mcp install main.py

クエリの例

サーバーを起動して Claude に接続したら、自然言語で操作できます：

• 「ユーザー ID <User_ID> のポートフォリオを作成してください。AAPL を30％、MSFT を20％、AMZN を15％、米国債を35％にしてください」
• 「私のポートフォリオの最近のパフォーマンスはどうですか？」
• 「私のポートフォリオに含まれる株式のニュースを見せてください」
• 「現在のポートフォリオの投資推奨事項を生成してください」
• 「現在の資産配分を可視化してください」

プロジェクト構成

portfolio-manager/
├── main.py                      # Entry point
├── portfolio_server/            # Main package
│   ├── api/                     # External API clients
│   │   ├── alpha_vantage.py     # Stock market data API
│   │   └── news_api.py          # News API
│   ├── data/                    # Data management
│   │   ├── portfolio.py         # Portfolio models
│   │   └── storage.py           # Data persistence
│   ├── resources/               # MCP resources
│   │   └── portfolio_resources.py # Portfolio resource definitions
│   ├── tools/                   # MCP tools
│   │   ├── analysis_tools.py    # Portfolio analysis
│   │   ├── portfolio_tools.py   # Portfolio management
│   │   ├── stock_tools.py       # Stock data and news
│   │   └── visualization_tools.py # Visualization tools
│   └── server.py                # MCP server setup
└── requirements.txt             # Dependencies

今後の作業

現時点では、この MCP プログラムは、各ユーザーの投資ポートフォリオを記録するために手動で作成された JSON ファイルを使用しています。

実際の銀行アプリケーションからポートフォリオデータを読み込むように修正する必要があります。

タスク

• ユーザーが使用している金融アプリケーションまたは銀行アプリケーションから JSON を抽出する
• クライアントによる投資ポートフォリオの変更を可能にする
• ポートフォリオの自動リバランスを実装する
• 暗号資産のサポートを追加する
• モバイルアプリケーションとの連携を開発する

ライセンス

MIT