让 AI Agent 直接调基金数据
填一个 URL 就行 —— 不用装 Python、不用下载脚本、不用自己维护进程。 配置好后,你在 Claude Desktop / Cursor / VS Code 里问「这只基金怎么样」, AI Agent 会调用下面 19 个工具去拿真实数据,而不是凭记忆编。
https://api.fundapi.cn/mcpAuthorization: Bearer cf-…仅接受 POST代码与自托管:GitHub 仓库(README 含各客户端配置、自测命令与更新记录)
让 AI Agent 帮你装
不用自己找配置文件、也不用改 JSON。把下面这段复制给你的 AI Agent,它会读官方接入说明、按你的客户端完成配置并验证。
请先读取 MCP 接入说明:https://fundapi.cn/install-mcp-workflow.md 然后按说明完成基金数据 API 的 MCP 配置与验证。 客户端:你自己判断(看运行环境就知道是 Claude Code / Cursor / VS Code / CodeBuddy / WorkBuddy / OpenCode 等),不用问我。 API Key:我给了就直接用;没给就先用免费工具做联通性验证,并告诉我哪些工具需要 Key。 需要 Key 时:去 https://fundapi.cn/pricing 自助开通(支付宝扫码,当场出 Key)。 要求: 1. 鉴权用 Authorization 头,不要改成 OAuth。 2. 不要跳过验证步骤:握手成功后确认能看到 19 个工具。 3. 配置失败时给出具体原因和修复建议,不要猜。
不想用 AI Agent 代劳?往下看手动配置,常见客户端各三行。
三步接入
写进客户端配置
把这段加进客户端的 MCP 配置,只改 API Key:
{
"mcpServers": {
"fundapi": {
"type": "http",
"url": "https://api.fundapi.cn/mcp",
"headers": {
"Authorization": "Bearer cf-你的Key"
}
}
}
}| 客户端 | 配置文件 |
|---|---|
| Claude Desktop | claude_desktop_config.json |
| Claude Code | .mcp.json |
| Cursor | .cursor/mcp.json |
| VS Code | .vscode/mcp.json |
| Codex | ~/.codex/config.toml |
| Gemini CLI | ~/.gemini/settings.json |
| Cline | ~/.cline/mcp.json |
| Windsurf | mcp_config.json |
| CodeBuddy | ~/.codebuddy/.mcp.json |
| WorkBuddy | ~/.workbuddy/mcp.json |
| Trae | 设置 → MCP → 手动配置 |
| Kimi Code | ~/.kimi/mcp.json |
| OpenCode | opencode.json |
| Kilo Code | kilo.jsonc |
| ZCode | ~/.zcode/cli/config.json |
| MiMo Code | mimocode.json |
| Manus | 设置 → 集成 → 自定义 MCP |
| Devin | ~/.config/devin/mcp_config.json |
| OpenClaw | ~/.openclaw/openclaw.json |
没有 API Key?把 headers 那行删掉也能用 —— 免费工具(搜索 / 档案 / 筛选项字典)不需要凭证;要全部 19 个工具再配 API Key。
客户端填不了自定义请求头时(例如部分网页版 connector),可改用https://api.fundapi.cn/mcp?key=cf-你的Key —— 两条路径的鉴权、额度、限流完全一致,只是凭据位置不同。
重启客户端,直接问
重启后工具列表里会出现 19 个 fund_* 工具。可以这样问:
- 「易方达消费行业这只基金怎么样」
- 「它上季新进了哪些股票」
- 「这只基金换过几次基金经理」
- 「我这两只基金有没有重复买」
- 「帮我找几只晨星五星的消费主题基金」
不开客户端也能验端点
一个请求就能确认 MCP 服务在线,不需要 Key、不需要装任何东西:
curl -s -X POST https://api.fundapi.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"1"}}}'返回里包含 "serverInfo":{"name":"fund-data-api"就说明服务在线;工具列表要等客户端握手后才会出现。
19 个工具
版本与 HTTP 端点一致 —— 免费工具不填 API Key 也能用| 工具 | 做什么 | 版本 |
|---|---|---|
fund_search | 按代码 / 名称 / 拼音找基金。用户只报了基金名时先用它换代码。 | 免费 |
fund_profile | 一次拿齐费率、10 档阶段涨幅与同类排名、经理、规模、仓位、持有人结构。 | 免费 |
fund_screener_options | 筛选项字典:类型树 / 公司 / 主题 / 收益区间 / 评级 / 排序字段。 | 免费 |
fund_nav | 历史净值:单位净值、累计净值、日增长率、申赎状态,支持日期区间。 | 体验版 |
fund_rank | 全市场排行,按阶段涨幅排序取前 N。 | 体验版 |
fund_notices | 公告索引:定期报告、公司公告、人事变更。 | 体验版 |
fund_holdings | 季报前十大重仓股:占净值比、持股数(万股)。 | 专业版 |
fund_managers | 在任经理:任职年限、在管规模、综合能力分与 5 项分项、任期收益对比。 | 专业版 |
fund_estimate | 盘中估值:实时估算与持仓模型两种估算,带逐股贡献。 | 专业版 |
fund_dividends | 分红送配:分红明细、份额折算、分红公告。 | 专业版 |
fund_trade_rule | 交易规则:申赎状态、T+N 确认到账、分档费率、渠道折扣价。 | 专业版 |
fund_rating | 逐报告期机构评级,看是在升还是在降。 | 专业版 |
fund_overlap | 多只基金重仓股重叠度,看有没有重复买。 | 机构版 |
fund_portfolio_xray | 组合穿透:一篮子基金合起来实际买了哪些股票、每只股票的综合权重与来源拆解。 | 机构版 |
fund_holding_changes | 这季新进 / 跌出前十 / 加仓减仓,含多期趋势。 | 机构版 |
fund_manager_history | 历任经理、任期回报、换人频率。 | 机构版 |
fund_portfolio_diagnose | 组合诊断:行业暴露、重仓穿透、仓位变化、费率合计。 | 机构版 |
fund_screener | 全市场筛选:类型 / 公司 / 主题 / 收益区间 / 评级,支持排序分页。 | 机构版 |
fund_compare | 2–5 只基金并列收益、费率、经理、持仓(只并列,不排序不给结论)。 | 机构版 |
19 个工具与 19 个 HTTP 端点一一对应,参数和字段说明见接口文档。
MCP 和 HTTP 是什么关系
同一个服务的两种调用方式:AI Agent 通过 MCP 调用,你的代码通过 HTTP 调用 —— 两者使用同一套端点、同一个 API Key、同一份额度,数据与计费完全一致。
选择只看调用方:Agent 场景用 MCP,程序内调用用 HTTP。两者可以同时使用,不需要为 MCP 另外购买权限。
离线环境或客户端只能跑本地命令时,也可以用 stdio 方式接入:fund-mcp.py(需 Python 3 + requests,配置项为 FUND_API / FUND_KEY), 或从 GitHub 仓库 克隆后自托管。