akfund-mcp

# akfund-mcp 中国公募基金 & 市场行情 MCP 工具，支持接入 Claude、Cursor 等 AI 客户端。 [](https://pypi.org/project/akfund-mcp/) --- ## 接入 AI 客户端 需要先安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)。 在对应客户端的配置文件中添加以下内容，然后重启客户端： ```json { "mcpServers": { "akfund": { "command": "uvx", "args": ["akfund-mcp@latest"] } } } ``` | 客户端 | 配置文件路径 | |---|---| | Claude 桌面版（macOS） | `~/Library/Application Support/Claude/claude_desktop_config.json` | | Claude 桌面版（Windows） | `%APPDATA%\Claude\claude_desktop_config.json` | | Cursor | 项目根目录 `.cursor/mcp.json` | | Claude Code | `~/.claude/settings.json` 或 `~/.claude.json` | --- ## 使用方式 akfund-mcp 只负责数据抓取，本身不包含任何投资逻辑。你需要在项目目录下创建一个规则文件，告诉 AI 你的持仓和决策偏好，然后每天对 AI 说一句话，它会自动拉取数据并给出操作建议。 ### 第一步：创建规则文件 在你的工作目录下新建一个 Markdown 文件（例如 `基金助手.md`），按以下模板填入你的信息： ```markdown # 基金每日决策助手 ## 持仓 | 基金代码 | 基金名称 | 持有份额 | 当前市值 | 仓位占比 | |---|---|---:|---:|---:| | XXXXXX | 基金名称A | 1000.00 | 0.00 | 0.00% | | XXXXXX | 基金名称B | 2000.00 | 0.00 | 0.00% | ## 收益追踪基准 - 基准日：YYYY-MM-DD，基准市值：XXXXX.XX - 收益 = 当前总市值 - 基准市值 - 追踪期累计净买入 - 收益率 = 收益 ÷ (基准市值 + 追踪期累计净买入) ## 决策偏好 （在这里写你的操作风格，例如：偏保守/偏激进、止盈止损规则、仓位上限等） ## 执行流程 每天说"按流程跑今天的基金决策"时： 1. 调用 get_trading_status() 判断今天是否交易日 2. 并发调用以下工具采集数据： - get_portfolio_brief() 一次获取持仓市值/技术指标/盘中估值/重叠预警 - calc_after_fee_return() 计算费后真实收益（fees_paid 默认 0） - get_daily_brief() 获取市场行情和新闻 3. 综合以上数据给出操作建议 4. 对每笔操作建议调用 run_trade_checklist_auto() 做免悔校验： - 自动查询 already_traded_today 和 holding_days，无需手动传入 - 买入时传入 total_position_pct（当前总仓位占比） - 买入时传入 overlap_warnings（来自 get_portfolio_brief 的 overlap.warnings 列表） - 买入时传入 vs_peer_3m（来自 get_portfolio_brief 的 ranks[code] 近3月 vs_peer 字段） - verdict=block：拦截，不输出该建议 - verdict=caution：保留建议，标注警告项 - verdict=proceed：正常输出 5. 调用 scan_new_capital(amount=新增资金金额) 输出新增资金推荐； 未提供新增资金金额时默认按 1000元 执行 ``` ### 第二步：开始使用 文件准备好后，每天只需对 AI 说： > 按流程跑今天的基金决策 --- ## 工具列表 ### 基金数据 | 工具 | 参数 | 说明 | |---|---|---| | `searc…