Portfolio Manager MCP Server

Portfolio Manager MCP Server

一个 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 Transport（默认，用于集成 Claude Desktop）：

   python main.py   # alternate commands: i.e.) python3, python3.11
   

2. SSE Transport（用于基于 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 后，你可以用自然语言与其交互：

• "创建一个投资组合，其中包含 30% 的 AAPL、20% 的 MSFT、15% 的 AMZN 和 35% 的美国国债，用户 ID 为 <User_ID>"
• "我的投资组合最近的表现如何？"
• "向我展示有关投资组合中股票的新闻"
• "为我当前的投资组合生成投资建议"
• "将我当前的资产配置可视化"

项目结构

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