🚀 投资组合管理 MCP 服务器
本项目是一个基于 Model Context Protocol (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 # 替换命令：i.e.) 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，您可以使用以下示例查询：
- 查看投资组合的当前状态：
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 许可证。