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 密鑰。

💻 使用示例

基礎用法

運行服務器

可以以兩種不同的模式運行服務器：

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 許可證。