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