投资组合管理器

Name: 投资组合管理器
Author: ikhyunAn

作者：ikhyunAn5 星标更新：2025-10-23

安装使用来源：spider==github.com

项目介绍

投资组合管理器 MCP 服务器

这是一个提供工具和资源用于管理和分析投资组合的模型上下文协议（MCP）服务器。

特性

投资组合管理：创建并更新包含股票和债券的投资组合
市场数据：获取实时股票价格信息及相关新闻
分析：生成全面的投资组合报告和绩效分析
推荐：根据投资组合构成获得个性化投资建议
可视化：创建投资组合分配的可视化表示

安装

克隆此仓库：

git clone https://github.com/ikhyunAn/portfolio-manager-mcp.git
cd portfolio-manager-mcp

安装所需依赖项：
```
pip install -r requirements.txt
```
设置API密钥（可选）：
```
export ALPHA_VANTAGE_API_KEY="your_key_here"
export NEWS_API_KEY="your_key_here"
```
或者，在根目录下创建一个.env文件并存储API密钥

使用方法

运行服务器

你可以以两种不同的模式运行服务器：

Stdio传输（默认，适用于Claude Desktop集成）：

python main.py   # 可选命令：例如 python3, python3.11

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