elliotfoster-mcp

Model Context Protocol(MCP)을 통한 AI 클라이언트용 브라질 투자 펀드 분석 서비스입니다.

Claude Desktop, Cursor, ChatGPT 또는 MCP 호환 클라이언트를 연결하여 30,000개 이상의 브라질 투자 펀드를 조회하세요. 일일 순자산가치(NAV), 전체 보유 자산(CDA), 재간접 펀드(Fund-of-funds) 상세 분석, 포트폴리오 중복 분석 및 개인 관심 종목/즐겨찾기 기능을 제공합니다.

서버 URL: https://elliotfoster.vercel.app/api/mcp 웹 앱 + 키 생성: elliotfoster.vercel.app

원천 데이터는 CVM(Comissão de Valores Mobiliários)의 공개 일일 보고서(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 (Custom GPT / Connectors)

Custom 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를 통해 펀드의 메타데이터 및 최신 NAV 조회. 형식화된(`12.345.678/0001-90`) 또는 원시(`12345678000190`) 입력 지원.
`list_fund_types`	펀드 유형별 개수 집계 — 탐색에 유용.
`get_nav_history`	펀드의 일일 NAV 시리즈. 날짜 범위 및 제한(최대 1000일) 설정 가능.
`list_holding_dates`	펀드의 보유 자산(CDA) 보고 가능 날짜 목록.
`get_holdings`	특정 날짜의 전체 포트폴리오 구성. CVM 결의안 172/2022에 따른 기밀 포지션에 대한 `confidential_count` 지표 포함.
`get_look_through`	재간접 펀드의 포지션을 최대 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 집중도, 룩스루(look-through), 기밀성 플래그 분석
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 보호 리소스 메타데이터는 RFC 9728을 구현하는 MCP 클라이언트와의 호환성을 위해 `/.well-known/oauth-protected-resource`에 게시됩니다. 실제로는 자동 검색 흐름이 생태계 전반에서 성숙해지는 단계이므로 현재는 API 키 사용을 권장합니다.
속도 제한	사용자별 속도 제한 적용 (현재는 넉넉하게 설정됨; 대량 사용 시 티어별 요금제 도입 예정)
소수점 정밀도	금융 값은 소수점 6자리까지 반올림. 모든 분석 응답에 최상위 `_precision_note`로 문서화됨.
CNPJ 형식	모든 CNPJ 입력은 형식화된 14자리 또는 원시 14자리 모두 허용; 서버 측에서 정규화 및 검증.
페이지네이션	`search_funds`는 페이지당 최대 25개, 세션당 최대 20페이지(500개 펀드)로 제한. 더 넓은 탐색을 위해서는 필터를 사용하세요.

개인정보 보호 및 데이터

공개 펀드 데이터(CVM 일일 보고서, CDA, 중앙은행 금리)는 모든 사용자에게 공유됩니다.
사용자별 상태(즐겨찾기, 감사 로그)는 WorkOS 사용자 ID를 통해 RLS(Row Level Security)로 범위가 지정됩니다. 도구나 데이터베이스가 귀하의 상태를 다른 계정에 노출하지 않습니다.
개인 거래 데이터는 저장되지 않습니다. 이 플랫폼은 펀드 조사용이며, 증권사와 연결되지 않습니다.
감사 로그: 도구 호출은 청구 및 오용 방지를 위해 기록됩니다. 로그는 엄격히 사용자별로 관리되며, 귀하는 자신의 사용 내역만 확인할 수 있습니다. 다른 계정은 이를 볼 수 없습니다.

출처

MCP 서버는 비공개 소스 웹 앱 내부에 구현되어 있습니다. 이 저장소는 설치 지침과 예제를 제공하며, MCP 서버를 인덱싱하는 AI 검색 엔진을 위한 표준 정보원 역할을 합니다. 문제 제기 및 피드백은 언제나 환영합니다.

데이터 라이선스 또는 상업적 문의는 elliotfoster.vercel.app을 참조하세요.

라이선스

이 저장소의 README 및 예제 구성 파일은 MIT 라이선스를 따릅니다. MCP 서버 자체는 독점 소프트웨어입니다.

Next.js + Supabase + WorkOS 기반의 mcp-handler로 구축되었습니다.

Elliot Foster – Brazilian Funds