vibe-finance-kit
This is a read-only investment research server with four MCP tools for ETF analysis and backtest auditing. It never offers trading, buy/sell recommendations, or holds broker credentials.
finance_kit_doctor– Returns server capabilities, confirming read-only mode and that no order tools are exposed.validate_etf_snapshot– Validates a singleETFAnalysisSnapshotJSON payload, checking structure integrity without filling gaps.compare_etf_snapshots– Compares two ETF snapshots, yielding comparable facts and warnings, but explicitly never a buy recommendation.audit_backtest_report– Audits aBacktestReportJSON for timing, cost assumptions, split periods, and evidence gate compliance, including look-ahead bias detection.
It supports disciplined investment research, source verification, missing-data handling, ETF product structure review, and index valuation metrics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vibe-finance-kit Please audit this backtest report for lookahead bias"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vibe Finance Kit
Vibe-Trading에서 검증된 투자 리서치 원칙을 Hermes 실습에 맞게 선별한 읽기 전용 Skill + MCP 키트다. 원본의 에이전트 런타임, UI, swarm, 브로커 주문 경로를 포크하지 않는다.
이 저장소가 담당하는 일:
출처·기준일·가용 시점을 보존하는 투자 리서치
ETF 상품 구조와 기초지수 가치지표 스냅샷 검증
백테스트 결과의 미래참조·비용·평가 구간·벤치마크 감사
이 저장소가 담당하지 않는 일:
매수·매도 추천
주문 기안, 승인 또는 실행
증권사 키·계좌번호 보관
이 프로젝트는 교육용 분석 도구이며 투자 자문, 매수·매도 추천 또는 수익 보장을 제공하지 않는다.
주문과 모의 계좌 연결은 별도 프로젝트 magma-finance-lab이 담당한다. 분석 MCP에 주문 도구를 추가하지 않는 것이 이 프로젝트의 보안 경계다.
출처와 파생 범위
Upstream: HKUDS/Vibe-Trading
검토 기준:
vibe-trading-ai0.1.13, commita1bb7ac02953c8e913fa72b4f7dceb357c699330라이선스: MIT
세부 채택·제외 목록은 UPSTREAM.md, 저작권 고지는 NOTICE를 본다.
Related MCP server: stock-mcp
Hermes 빠른 설치
git clone https://github.com/dandacompany/vibe-finance-kit.git
cd vibe-finance-kit
uv run python scripts/setup_hermes.py같은 명령을 macOS, Linux·WSL, Windows PowerShell에서 사용한다. 이 명령은 프로젝트
환경과 패키지를 설치하고, Ada에는 분석 Skill 3개와 읽기 전용 MCP를,
Oliver에는 리서치 Skill 2개를 등록한다. MCP 도구 4개 활성화 질문이 나오면 Y를
입력한다. 기본 기능에는 API 키와 .env가 필요하지 않다.
설치가 끝나면 Ada와 Oliver를 새 세션으로 시작한다. Ada에게
finance_kit_doctor를 호출하도록 요청해 mode=read_only, tools=4,
order_tools=[], broker_credentials_required=false를 확인한다.
검증된 환경:
환경 | MCP 실행 파일 | 전체 setup 결과 |
macOS |
| Skill 3/2개·MCP 4개 통과 |
Linux·WSL |
| Skill 3/2개·MCP 4개 통과 |
Windows PowerShell |
| Skill 3/2개·MCP 4개 통과 |
설치 확인과 복구
설정을 변경하지 않고 패키지, Hermes 경로, MCP 실행 파일, doctor만 확인할 수 있다.
uv run python scripts/setup_hermes.py --check빠른 설치가 중단됐다면 오류를 해결한 뒤 uv run python scripts/setup_hermes.py를 다시
실행한다. 운영체제별 .venv 경로나 개별 Skill·MCP 명령을 직접 입력할 필요가 없다.
설치되는 역할:
Skill | 역할 |
| 출처·시점·반대 근거·결측 규율 |
| ETF 상품 구조와 기초지수 가치지표 분석 |
| 미래참조·과적합·비용·벤치마크 감사 |
빠른 검증
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python -m vibe_finance_kit.doctor첫 데이터 검증에는 examples/etf-analysis-snapshot.json을 사용한다. 값은 고정 fixture이며 실제 투자 판단 자료가 아니다.
공개 전 남은 게이트
Hermes 녹화 프로필에서 Skill 원격 설치 실측
MCP 등록 후 도구 목록과 첫 호출 실측
Section 8 샘플
ETFAnalysisSnapshot으로 end-to-end 검증hermes skills audit결과 보존
Available Tools
4 toolsaudit_backtest_reportB
Audit a BacktestReport for timing, cost, split, and evidence gates.
Inputs: report_json (required). Returns: object
compare_etf_snapshotsB
Return comparable ETF facts and warnings; never emit a buy recommendation.
Inputs: left_json (required), right_json (required). Returns: object
finance_kit_doctorA
Return capabilities and prove that this server exposes no order tools.
Inputs: no named parameters. Returns: object
validate_etf_snapshotA
Validate one ETFAnalysisSnapshot without filling missing values.
Inputs: snapshot_json (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct operation: an introspection probe, single-snapshot validation, snapshot comparison, and backtest audit. There is no overlap or ambiguity between them.
Three tools follow a clear verb_noun pattern (validate_etf_snapshot, compare_etf_snapshots, audit_backtest_report), but finance_kit_doctor breaks the convention with a noun phrase, making the naming set feel slightly inconsistent.
Four tools is a reasonable size for a specialized finance-kit server, though it sits near the lower end of the typical 3-15 band. The scope appears focused and not overburdened.
The tool surface covers validation, comparison, and audit for the core domain. A minor gap is the lack of any creation or mutation tools, but for an analysis-focused kit this is acceptable and does not leave obvious dead ends.
Maintenance
Related MCP Connectors
Read-only market research: index funds, event cards, CLOB data, fund analytics. No orders.
Read-only paper risk evidence and policy-gated committed event research. No real orders.
Read-only market charts, OHLC, backtests and a view of your connected broker accounts
Read-only cited financial datasets, bounded research queries and source diagnostics.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides read-only access to justETF data including ETF search, profiles, charts, comparisons, and live quotes via MCP tools.251MIT
- FlicenseNot gradedqualityCmaintenanceProvides deterministic A-share market snapshots and immutable strategy versions for short-term review, exposing verified daily reports via MCP without order or account management.-
- AlicenseNot gradedqualityCmaintenanceProvides read-only MCP tools for market snapshots, position risk, order reconciliation, and daily report previews with deterministic financial calculations, evidence chains, and audit trails.MIT
- FlicenseAqualityCmaintenanceEnables read-only, bounded quantitative-research workflows with schema compatibility checking and server capability discovery, without exposing market data or live trading.1-