elliotfoster-mcp

通过模型上下文协议 (MCP) 为 AI 客户端提供巴西投资基金分析。

连接 Claude Desktop、Cursor、ChatGPT 或任何支持 MCP 的客户端，即可查询 30,000 多只巴西投资基金——包括每日净值 (NAV)、完整持仓 (CDA)、基金中的基金 (FoF) 穿透分析、投资组合重叠分析以及您的个人收藏/关注列表。

服务器 URL： https://elliotfoster.vercel.app/api/mcp Web 应用 + 密钥生成： elliotfoster.vercel.app

源数据来自巴西证券交易委员会 (CVM) 的公开每日报告 (Informe Diário) 和 CDA，以及巴西中央银行的利率序列。该平台对数据进行处理、验证，并以针对 LLM 工具使用优化的结构化格式提供服务。

快速入门

1. 获取密钥

在 elliotfoster.vercel.app 创建账户，登录并访问 /settings/integrations。生成一个新密钥并复制它（原始密钥仅显示一次）。

2. 配置您的 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "elliotfoster": {
      "url": "https://elliotfoster.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ef_..."
      }
    }
  }
}

重启 Claude Desktop。

Cursor

在 Cursor 设置 → MCP 中，添加：

{
  "elliotfoster": {
    "url": "https://elliotfoster.vercel.app/api/mcp",
    "headers": {
      "Authorization": "Bearer ef_..."
    }
  }
}

ChatGPT (自定义 GPT / 连接器)

在自定义 GPT 的 Actions 或通过 Connectors 界面，指向 https://elliotfoster.vercel.app/api/mcp，并将 Authorization: Bearer ef_... 作为请求头。

Claude Code

claude mcp add --transport http --header "Authorization=Bearer ef_..." elliotfoster https://elliotfoster.vercel.app/api/mcp

3. 尝试使用

向您的 LLM 提问：

“使用 elliotfoster 搜索名称中包含 'XP' 的基金”
“基金 12.345.678/0001-90 和 98.765.432/0001-21 之间的持仓重叠度是多少？”
“将基金 X 添加到我的收藏”
“查找与基金 Y 相关性较低的股票型基金”

工具

包含 10 个可调用工具、1 个资源和 5 个预设分析提示词。

工具	功能描述
`search_funds`	按名称、管理人、托管人或 CNPJ 搜索。支持按类型（FI, FIC, FII, FIP, FIDC, FIAGRO, ETF）筛选。每页限制 25 条。
`get_fund`	通过 CNPJ 获取基金的元数据 + 最新净值。接受格式化 (`12.345.678/0001-90`) 或原始 (`12345678000190`) 输入。
`list_fund_types`	按基金类型统计数量——有助于发现基金。
`get_nav_history`	基金的每日净值序列。支持可选的日期范围和限制（最多 1000 天）。
`list_holding_dates`	基金可用的持仓 (CDA) 报告日期。
`get_holdings`	指定日期的完整投资组合构成。包含针对 CVM 第 172/2022 号决议保密条款下头寸的 `confidential_count` 指标。
`get_look_through`	递归展开基金中的基金 (FoF) 头寸，最多支持 3 层深度。按比例权重汇总底层资产。
`compare_overlap`	计算两只基金在报告日期的 Jaccard 重叠度 + 共享权重。
`list_favorites`	查看您的收藏基金。
`add_favorite` / `remove_favorite`	直接从 LLM 客户端管理您的关注列表。

资源

fund://<cnpj> — 可寻址的基金元数据，支持 MCP 资源的客户端可对其进行缓存。

预设提示词

compare_funds_performance — 最多 5 只基金的并排收益/波动率/夏普比率对比（对比 CDI）
find_uncorrelated_funds — 筛选相对于基准相关性较低的基金
analyze_fund_holdings — 前 10 大持仓、HHI 集中度、穿透分析、保密标记
check_portfolio_overlap — 2-5 只基金之间的两两冗余审计
screen_funds_by_risk — 按最大波动率和最小夏普比率进行筛选

所有提示词默认输出为葡萄牙语 (pt-BR)（与源数据语言一致）。

规范


端点	`https://elliotfoster.vercel.app/api/mcp`
传输	可流式传输 HTTP (MCP 规范 2025 年 11 月版)
发现	`/.well-known/oauth-protected-resource` (RFC 9728)
认证	API 密钥 (`Authorization: Bearer ef_...`)。OAuth 2.1 受保护资源元数据发布在 `/.well-known/oauth-protected-resource`，以实现与实现 RFC 9728 + 动态客户端注册的 MCP 客户端的前向兼容；实际上，自动发现流程在整个生态系统中尚在成熟阶段，因此目前推荐使用 API 密钥。
速率限制	适用每用户速率限制（目前较为宽松；高频使用将采用分级定价）
小数精度	金融数值四舍五入至小数点后 6 位。每个分析响应的顶层 `_precision_note` 字段对此进行了说明。
CNPJ 格式	所有 CNPJ 输入均接受格式化或 14 位原始格式；在服务器端进行标准化和验证。
分页	`search_funds` 每页限制 25 条，单次会话最多 20 页（500 只基金）。如需更广泛的探索，请使用筛选器。

隐私与数据

公共基金数据（CVM 每日报告、CDA、中央银行利率）在所有用户之间共享。
用户状态（收藏、审计日志）通过您的 WorkOS 用户 ID 进行 RLS（行级安全）隔离——工具和数据库均不会向其他账户公开您的状态。
不存储个人交易数据。 这是一个基金研究平台；它不连接任何经纪商。
审计日志： 工具调用会被记录，用于计费和防止滥用。日志严格按用户隔离——您可以查看自己的使用情况；其他账户无法查看。

来源

MCP 服务器在闭源 Web 应用内部实现。此仓库提供安装说明、示例，并作为索引 MCP 服务器的 AI 搜索引擎的权威来源。欢迎在此提交问题和反馈。

有关数据授权或商业咨询：请访问 elliotfoster.vercel.app。

许可

本仓库中的 README 和示例配置采用 MIT 许可。MCP 服务器本身为专有软件。

基于 mcp-handler 构建，使用 Next.js + Supabase + WorkOS。

Elliot Foster – Brazilian Funds