投资组合管理 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 密钥

使用

运行服务器

您可以在两种不同的模式下运行服务器：

1. Stdio 传输 (默认，用于 Claude Desktop 集成):

   python main.py   # 备用命令: 例如) 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>"
• "我的投资组合最近的表现如何？"
• "向我展示有关我的投资组合中的股票的新闻"
• "为我当前的投资组合生成投资建议"
• "可视化我当前的资产配置"

项目结构

portfolio-manager/
├── main.py                      # 入口点
├── portfolio_server/            # 主包
│   ├── api/                     # 外部 API 客户端
│   │   ├── alpha_vantage.py     # 股票市场数据 API
│   │   └── news_api.py          # 新闻 API
│   ├── data/                    # 数据管理
│   │   ├── portfolio.py         # 投资组合模型
│   │   └── storage.py           # 数据持久性
│   ├── resources/               # MCP 资源
│   │   └── portfolio_resources.py # 投资组合资源定义
│   ├── tools/                   # MCP 工具
│   │   ├── analysis_tools.py    # 投资组合分析
│   │   ├── portfolio_tools.py   # 投资组合管理
│   │   ├── stock_tools.py       # 股票数据和新闻
│   │   └── visualization_tools.py # 可视化工具
│   └── server.py                # MCP 服务器设置
└── requirements.txt             # 依赖项

未来工作

目前，MCP 程序使用手动创建的 JSON 文件来跟踪每个用户的投资组合。

应该修复此问题，以便从实际的银行应用程序中读取投资组合数据。

任务

• [ ] 从用户使用的金融或银行应用程序中提取 JSON
• [ ] 允许客户端修改投资组合
• [ ] 实施自动投资组合再平衡
• [ ] 增加对加密货币资产的支持
• [ ] 开发移动应用程序集成

许可证

MIT