스타트업 재무 지표 (MCP 서버)

Name: startup-finance-metrics
Author: MayankTalwar0

스타트업의 재무 건전성을 분석하고 지표 보고서를 로컬에서 생성하기 위한 MCP(Model Context Protocol) 서버입니다.

🔒 개인정보 보호 및 보안 우선:
클라우드 위험 제로: 이 도구는 사용자의 컴퓨터/서버에서 100% 로컬로 실행됩니다.
외부 데이터 전송 없음: 재무 데이터는 외부 API, 클라우드 제공업체 또는 타사 서비스(SlickBooks 포함)로 절대 전송되지 않습니다.
데이터 저장 없음: 서버는 메모리 내에서 입력을 처리하고 MCP 클라이언트에 지표를 직접 반환합니다. 데이터는 저장, 캐시 또는 기록되지 않습니다.
엄격한 읽기 전용: 이 서버는 재무 상태 변경을 수행하지 않습니다. 엄격하게 읽기 전용인 수학적 엔진입니다.
엄격한 로컬 처리: 민감한 재무 입력에 대한 완전한 데이터 주권을 유지하면서 Claude Desktop, Cursor, Glama 및 기타 MCP 클라이언트와 안전하게 통합됩니다.

이 도구가 필요한 이유

자금 조달을 준비하거나 이사회 회의를 앞둔 스타트업 창업자라면 투자자들은 MRR, 번 레이트(Burn Rate), 매출 총이익률, LTV:CAC, 런웨이(Runway)와 같은 지표를 갑작스럽게 요구할 것입니다. 대부분의 창업자는 이러한 지표를 일관되게 추적하지 않거나, 자금 조달 때마다 은행 명세서와 스프레드시트에서 숫자를 뽑느라 몇 시간을 허비합니다.

이 도구는 원시 은행 명세서(또는 Stripe/QBO 내보내기 파일)를 몇 분 만에 구조화된 재무 지표 보고서로 변환하며, 모든 과정은 사용자의 컴퓨터에서 이루어집니다. 초기 검토를 위해 회계사가 필요하지 않으며, 민감한 데이터가 컴퓨터 밖으로 나가지 않습니다.

주요 기능

데이터 수집: 은행 CSV, Stripe 내보내기 CSV, QBO/Xero 내보내기 CSV 또는 붙여넣은 값을 허용합니다. (최상의 결과를 위해 최소 3개월치의 은행 명세서와 활성 사용자 통계를 제공하세요. 샘플 파일은 test/ 폴더에서 확인할 수 있습니다.)
AI 거래 분류: AI가 설명을 바탕으로 각 은행 거래를 수익, 매출원가(COGS), 판매 및 마케팅(S&M), 급여 또는 일반 관리비(G&A)로 분류합니다. 이 단계는 AI 기반이므로 오류가 발생할 수 있습니다. — 예: 계약직 지급액을 급여와 COGS 사이에서 잘못 분류하거나 모호한 항목을 놓칠 수 있습니다. 투자자와 결과를 공유하기 전에 항상 분류 내용을 검토하세요.
핵심 지표 계산: 순 번 레이트, 런웨이, 매출 총이익률, CAC, LTV, 40의 법칙 등을 계산하며, 단일 또는 여러 달에 걸친 비교 보고서를 생성합니다.
엄격한 검증: 값을 환각(hallucination)하는 대신 missing_inputs와 함께 insufficient_data를 반환합니다. 데이터가 누락되었거나 모호한 경우, 엔진은 추측하는 대신 필요한 정보를 알려줍니다.
보고서 생성: 깔끔하게 서식이 지정된 Markdown 및 HTML 보고서를 생성합니다. 제공된 모든 달을 포괄하는 통합 보고서와 기간별 비교 보고서를 제공합니다.

mcp-name: io.github.MayankTalwar0/startup-finance-metrics

설정 및 설치

옵션 1: Claude Desktop (비개발자를 위한 수동 설치)

이 도구는 재무 데이터를 보호하기 위해 사용자의 컴퓨터에서 완전히 실행되므로 일회성 수동 설정이 필요합니다. 좋은 소식: Python을 설치할 필요가 없습니다! 아래에서 사용하는 도구(uv)가 필요한 모든 것을 백그라운드에서 자동으로 다운로드합니다.

1단계: uv 설치 이 서버는 로컬에서 실행하기 위해 uv(빠른 Python 관리자)를 사용합니다. 설치되어 있지 않다면:

Mac/Linux: 터미널을 열고 다음을 실행하세요: curl -LsSf https://astral.sh/uv/install.sh | sh
Windows: PowerShell을 열고 다음을 실행하세요: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2단계: Claude 설정 열기

Claude Desktop 앱을 엽니다.
왼쪽 상단 메뉴에서 Claude -> Settings(또는 Preferences)를 클릭합니다.
왼쪽 사이드바에서 Developer 탭을 클릭합니다.
Edit Config 버튼을 클릭합니다. 기본 텍스트 편집기에서 claude_desktop_config.json 파일이 열립니다.

3단계: 서버 추가 파일 내용을 다음 코드로 교체하세요(이미 다른 서버가 있는 경우 기존 mcpServers 블록 안에 startup-finance-metrics 블록을 추가하기만 하면 됩니다):

{
  "mcpServers": {
    "startup-finance-metrics": {
      "command": "uvx",
      "args": [
        "startup-finance-mcp"
      ]
    }
  }
}

4단계: Claude 재시작 파일을 저장하고 닫은 후 Claude Desktop을 완전히 재시작하세요. 이제 Claude 채팅창에 새로운 "망치"(도구) 아이콘이 표시됩니다!

옵션 2: Claude Code, Glama 또는 사용자 지정 Cursor 설정

Claude Code와 같은 CLI 에이전의 경우, 또는 Glama 및 Cursor를 수동으로 구성하려는 경우 uvx 명령을 사용하세요:

Claude Code의 경우:

claude mcp add startup-finance -- uvx startup-finance-mcp

Glama / Cursor (사용자 지정 MCP 구성)의 경우:

uvx startup-finance-mcp

옵션 3: 로컬 개발

git clone https://github.com/MayankTalwar0/startup-finance-metrics.git
cd startup-finance-metrics
pip install -e .

# Run the server directly
startup-finance-mcp

사용 가능한 MCP 도구

이 서버는 MCP 클라이언트에 다음 도구를 제공합니다:

computeFinancialMetrics(inputs_json: str): 구조화된 입력에서 스타트업 재무 지표(런웨이, 매출 총이익률, CAC, LTV 등)를 계산합니다. 다개월 데이터를 분석할 때 월별로 한 번씩 호출됩니다.
generateFinancialReport(metrics_json: str, output_dir: str): 통합 HTML + Markdown 보고서를 렌더링합니다. 단일 월 페이로드 또는 다개월 {"months": [...]} 페이로드를 허용하여 제공된 모든 기간에 걸친 비교 보고서를 생성합니다.

독립형 AI 스킬로 사용하기

전체 MCP 서버를 사용하지 않고 Claude Code나 OpenClaw와 같은 도구에서 간단한 프롬프트만 사용하려면 skills/SKILL.md에서 원시 스킬 프롬프트를 찾을 수 있습니다.

지표 참조

#	지표	공식	필수 입력값
1	순 번 레이트	`monthly_opex - monthly_revenue`	`monthly_opex`, `monthly_revenue`
2	런웨이	`current_cash / net_burn`	`current_cash`; `net_burn > 0` 필요 (그렇지 않으면 `not_applicable: business is cash flow positive` 반환)
3	매출 총이익률	`(monthly_revenue - cogs) / monthly_revenue * 100`	`monthly_revenue`, `cogs`
4	CAC	`sales_marketing_spend / new_customers`	`sales_marketing_spend`, `new_customers`
5	LTV	`(ARPU * gross_margin) / logo_churn_rate`	`monthly_revenue`, `active_customers`, `lost_customers`, `cogs`
6	LTV:CAC	`ltv / cac`	계산 가능한 `ltv`, 계산 가능한 `cac`
7	매출 성장률	`(monthly_revenue - prev_monthly_revenue) / prev_m... * 100`	`monthly_revenue`, `prev_monthly_revenue`
8	고객 이탈률	`lost_customers / active_customers * 100`	`lost_customers`, `active_customers`
9	번 멀티플	`net_burn / (arr_end - arr_start)`	`monthly_opex`, `monthly_revenue`, `arr_start`, `arr_end`
10	NRR	`(start + exp - churn - cont) / start * 100`	`starting_mrr`, `expansion_mrr`, `churned_mrr`, `contraction_mrr`
11	40의 법칙	`revenue_growth_yoy_pct + operating_margin_pct`	`revenue_growth_yoy_pct`, `operating_margin_pct`
12	CAC 회수 기간	`cac / (ARPU * gross_margin)`	계산 가능한 `cac`, `monthly_revenue`, `active_customers`, 계산 가능한 `gross_margin`

라이선스

MIT

SlickBooks 제작

SlickBooks의 창업자 Mayank가 제작했습니다. SlickBooks는 관리형 부기, 부기 자동화, 재무 예측 자동화 및 맞춤형 재무 에이전트를 제공합니다.

startup-finance-metrics