fund-advisor-mcp

基金投顾 MCP 服务器 - 为 Claude Desktop / Cherry Studio 提供中国基金数据查询和投资建议

功能特性

• 🎯 五维基金组合推荐 - 从稳健到激进，覆盖不同风险偏好
• 📊 基金排名查询 - 按类型、时段获取基金排名
• 🔍 基金搜索 - 通过代码或名称搜索基金
• 📈 持仓分析 - 查询基金前十大重仓股
• 💎 板块头部基金 - 获取各行业板块的优质主动管理基金
• 🎨 ETF查找 - 按板块/行业查找相关ETF

MCP 工具列表

本服务器提供 11 个 MCP 工具：

| 工具名称 | 功能说明 | |---------|---------| | get_portfolio_v1_defensive | V1 稳健版 - 债券为主，⭐低风险 | | get_portfolio_v2_balanced | V2 均衡版 - 股债平衡，⭐⭐中低风险 | | get_portfolio_v3_growth | V3 成长版 - 权益为主，⭐⭐⭐中高风险 | | get_portfolio_v4_rotation | V4 行业轮动版 - 动态捕捉，⭐⭐⭐⭐高风险 | | get_portfolio_v5_index | V5 指数版 - 被动投资，⭐⭐中风险 | | get_all_portfolios | 一次性获取全部5个版本组合 | | search_fund | 搜索基金（代码/名称） | | get_fund_holdings | 查询基金持仓明细 | | get_fund_ranking | 获取基金排名列表 | | find_sector_etf | 查找板块ETF | | get_sector_top_funds | 获取板块头部主动基金 |

安装

npm install -g @your-username/fund-advisor-mcp

配置

Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 添加：

{
  "mcpServers": {
    "fund-advisor": {
      "command": "npx",
      "args": ["-y", "@your-username/fund-advisor-mcp"]
    }
  }
}

Cherry Studio

在设置 -> MCP 配置中添加：

{
  "fund-advisor": {
    "command": "npx",
    "args": ["-y", "@your-username/fund-advisor-mcp"]
  }
}

重启应用后即可使用。

使用示例

在 Claude Desktop 中询问：

帮我推荐一些稳健的基金组合

查询招商中证白酒指数基金的持仓

找一些消费板块的优质基金

数据来源

• 东方财富 - 基金列表、排名、净值历史、持仓数据
• 天天基金 - 基金详情、持仓明细

命令行使用

也可以直接在命令行运行（查看完整推荐）：

# 启动 MCP 服务器
fund-advisor-mcp

# 或直接运行推荐引擎
npx @your-username/fund-advisor-mcp

五维组合详解

V1 稳健版 ⭐

• 风格: 债券为主
• 配置: 长债 + 中短债 + 偏债混合 + 货币
• 风险: 低风险
• 适合: 保守型投资者

V2 均衡版 ⭐⭐

• 风格: 股债平衡
• 配置: 宽基指数 + 偏股混合 + 纯债
• 风险: 中低风险
• 适合: 稳健增长型

V3 成长版 ⭐⭐⭐

• 风格: 权益为主
• 配置: 行业ETF + 主动权益精选
• 风险: 中高风险
• 适合: 进取型投资者

V4 行业轮动版 ⭐⭐⭐⭐

• 风格: 动态捕捉
• 配置: 实时行业排名 → 动量最强板块ETF
• 风险: 高风险
• 适合: 交易型投资者

V5 指数版 ⭐⭐

• 风格: 被动投资
• 配置: 核心宽基 + 行业卫星配置
• 风险: 中风险
• 适合: 长期定投型

评分模型

基金评分采用多维度算法：

score = 0.30 × 近1年收益(归一化)
      + 0.20 × 近3年收益(归一化)
      + 0.15 × 近6月收益(归一化)
      + 0.10 × 规模适中得分
      - 0.15 × 费率惩罚
      - 0.10 × 规模惩罚

• 费率惩罚: 管理费 1.5% 扣 0.5 分
• 规模惩罚: <5000万（清盘风险）或 >800亿（灵活性下降）

开发

git clone https://github.com/your-username/fund-advisor-mcp.git
cd fund-advisor-mcp/node
npm install
npm test

注意事项

• 数据来自公开API，仅供参考
• API有频率限制，已实现600ms间隔保护
• 基金持仓数据为季度更新
• 净值数据为T+1更新

免责声明

本工具仅供学习研究使用，所有数据来自公开API，不构成任何投资建议。投资有风险，入市需谨慎。

License

MIT © [Your Name]

相关链接

• GitHub Repository
• Issues
• Model Context Protocol