gov-support-mcp

목차

1. 프로젝트 개요

배경 및 목적

메타 정보

2. 구현된 Tool 전체 목록

통합 탐색 / 분석

신청 준비 도구

관리 도구

단일 소스 조회 (개별 API 직접 호출)

3. 사용 시나리오

시나리오 1 — 통합 탐색 + 자격 판정 (병원 총무팀)

우리 병원 정보야.
- 서울 소재 내과·외과 2차 병원, 병상 150개, 의료인력 80명
- 법인병원, 설립 12년차, 연매출 120억
- 올해 신규 간호사 10명 채용 계획
1. searchGovernmentSupport로 인력·경영 분야 중복 없이 통합 조회해줘
2. 각 공고마다 우리 병원이 자격되는지 checkEligibility로 판정해줘
3. 자격 될 것 같은 것 중 마감 임박한 TOP 3 추려줘
4. TOP 3 각각 서류 체크리스트랑 타임라인도 뽑아줘

시나리오 2 — 지역별 비교 + 알림 설정 (스타트업)

AI 헬스케어 스타트업, 2023년 창업, 직원 12명, 서울, 매출 3억.
1. compareByRegion으로 서울·경기·전국 창업 지원사업 현황 비교해줘
2. 서울이 더 많으면 서울 기준 창업 분야 공고 상위 10개 보여줘
3. 이 조건(창업·기술 분야, AI 키워드, 서울·전국)으로 알림 프로파일 저장해줘
4. 가장 유망한 공고 1개 사업계획서 초안도 잡아줘
 (제품: AI 기반 원격 의료 상담 플랫폼, 목표 시장: 중소병원)

시나리오 3 — 전체 신청 프로세스 자동화 (중소기업)

경기도 안산 금속 가공 제조업, 직원 45명, 연매출 80억.
수출 30%(일본·동남아), 연구전담부서·ISO9001 보유.
사업자번호: 123-45-67890
1. 수출·기술 분야 통합 검색해서 지원금 클 것 같은 공고 5개 찾아줘
2. 각 공고 자격 체크하고 신청 가능한 것만 남겨줘
3. 가장 좋은 공고 1개 골라서:
 - 서류 체크리스트 뽑아줘 (마감일 20260530)
 - 역산 타임라인 만들어줘
 - 사업계획서 초안 잡아줘
4. 이 회사 프로파일을 저장해둬

시나리오 4 — 수혜 이력 관리 + 정산 보고서 (지원사업 수혜 기업)

스마트팩토리 사업을 선정받았어.
- 공고: 2026년 중소기업 스마트제조 혁신 지원사업
- 기관: 중소벤처기업부
- 승인금액: 5000만원, 사업 기간: 2026年03月01日 ~ 2026年12月31日
1. 수혜 이력 등록해줘 (사업자번호: 123-45-67890, 회사명: 안산정밀제조)
2. 지출 내역 추가해줘:
 - 인건비 1,200만원 (2026年04月30日, 김OO 외 2명 인건비)
 - 장비구매 800만원 (2026年04月15日, 비전검사 카메라 구매)
3. 현재 집행률이랑 잔액 확인해줘
4. 상반기 정산 보고서 초안 만들어줘 (2026年03月01日 ~ 2026年06月30日)

시나리오 5 — 예비창업자 지원사업 매칭 + 일정 계획

퇴직 후 친환경 소재 B2B 스타트업 준비 중. 법인 미설립, 특허 1건 보유.
서울 거주, 40대 중반, 초기 자금 5천만원.
1. K-Startup 예비창업자 대상 공고 + 기업마당 창업 분야 통합 조회해줘
2. 법인 설립 전 신청 가능 공고, 특허 우대 공고 각각 표시해줘
3. 지원금 형태(보조금/융자/공간/교육)별로 분류해줘
4. 관심 공고 중 마감 가장 빠른 것 골라서 타임라인 짜줘
5. 이 조건으로 정기 알림 프로파일 저장해줘

시나리오 6 — 임원 보고용 요약 + 지역 비교

IT 서비스업, 서울, 직원 200명, 코스닥 상장.
1. 이번 달 마감 공고 통합 조회해서 아래 형식 표로 정리해줘:
 | 공고명 | 지원기관 | 지원금액 | 마감일 | 자격요건 핵심 | 권장 여부 |
2. "상장사 제외" 또는 "중소기업만" 조건 공고 제외해줘
3. 서울·경기·전국 공고 현황 지역 비교도 추가해줘
4. 신청 권장 TOP 3 요약 + 각각 서류 체크리스트 첨부해줘

4. 아키텍처

Claude Desktop / Cursor / MCP 클라이언트
 │
 │ MCP stdio
 ▼
┌──────────────────────────────────────────────────┐
│ gov-support-mcp (server.ts) v1.0.0 │
│ │
│ Core 레이어 │
│ ├ core/dedup.ts — Jaccard 중복 제거 엔진 │
│ ├ core/store.ts — JSON 파일 영속성 저장소 │
│ ├ core/cache.ts — 인메모리 TTL 캐시 │
│ └ smesQueryEncoding.ts — 이중 인코딩 방지 유틸 │
│ │
│ ✅ 모듈 1: 통합 탐색 │
│ ├ searchGovernmentSupport (3소스 통합 + dedup) │
│ ├ compareByRegion │
│ ├ search_gov_support_bizinfo │
│ ├ search_gov_support_kstartup │
│ └ search_gov_support_smes24 ✅ 키발급(서버IP등록後) │
│ │
│ ✅ 모듈 2: 판정 │
│ └ checkEligibility │
│ │
│ ✅ 모듈 3: 준비 │
│ ├ generateDocumentChecklist │
│ ├ buildApplicationTimeline │
│ └ draftBusinessPlan │
│ │
│ ✅ 모듈 4: 관리 │
│ ├ manageAlertProfile │
│ ├ manageBenefitHistory │
│ └ draftSettlementReport │
└──────────────────────────────────────────────────┘
 │
 ▼
외부 API: bizinfo ✅ · K-Startup ✅ · 중소벤처24 ✅ 키발급완료(서버IP 등록 후 완전 활성) · 벤처확인 🔲(추후)
영속 데이터: data/alertProfiles.json · benefitHistory.json · companyProfiles.json

5. 필요 API 및 키 신청

API 목록

키 신청 방법

1 공공데이터포털 serviceKey — K-Startup · 벤처확인서 공통

2 중소벤처24 Open API 토큰

3 기업마당 API

환경변수 설정

cp .env.example .env
# .env 파일에 발급받은 키 입력

# 공공데이터포털(data.go.kr) Encoding serviceKey — K-Startup에 사용
PUBLIC_DATA_SERVICE_KEY=여기에_포털_Encoding_키
# 중소벤처24 전용 토큰 — smes.go.kr 별도 신청 · 서버 IP 허용 필요
# Encoding 키(%2B, %2F 등)를 그대로 붙여 넣으세요 (코드에서 자동 처리)
SMES24_API_KEY=여기에_중소벤처24_토큰
# 기업마당(bizinfo.go.kr) API 인증키 — bizinfo.go.kr 자체 포털에서 신청
BIZINFO_API_KEY=여기에_bizinfo_키

6. 설치 및 빌드

# 저장소 클론
git clone https://github.com/boam79/gov_support_mcp.git
cd gov_support_mcp
# 의존성 설치
pnpm install
# 환경변수 설정
cp .env.example .env
# .env 파일에 API 키 입력
# TypeScript 빌드
pnpm build

7. Cursor에 MCP 등록

{
 "mcpServers": {
 "gov-support-mcp": {
 "command": "node",
 "args": ["/절대경로/gov_support_mcp/dist/server.js"],
 "env": {
 "PUBLIC_DATA_SERVICE_KEY": "발급받은_포털_Encoding_키",
 "SMES24_API_KEY": "발급받은_중소벤처24_토큰",
 "BIZINFO_API_KEY": "발급받은_bizinfo_키"
 }
 }
 }
}

8. Claude Desktop에 MCP 등록

{
 "mcpServers": {
 "gov-support-mcp": {
 "command": "node",
 "args": ["/절대경로/gov_support_mcp/dist/server.js"],
 "env": {
 "PUBLIC_DATA_SERVICE_KEY": "발급받은_포털_Encoding_키",
 "SMES24_API_KEY": "발급받은_중소벤처24_토큰",
 "BIZINFO_API_KEY": "발급받은_bizinfo_키"
 }
 }
 }
}

개발 중 pnpm dev 모드로 연결

{
 "mcpServers": {
 "gov-support-mcp": {
 "command": "pnpm",
 "args": ["--dir", "/절대경로/gov_support_mcp", "dev"],
 "env": {
 "PUBLIC_DATA_SERVICE_KEY": "발급받은_포털_Encoding_키",
 "SMES24_API_KEY": "발급받은_중소벤처24_토큰",
 "BIZINFO_API_KEY": "발급받은_bizinfo_키"
 }
 }
 }
}

9. 개발 명령어

pnpm install # 의존성 설치
pnpm build # TypeScript → dist/ 컴파일
pnpm test # 단위 테스트 (vitest)
pnpm dev # MCP 서버 실행 (stdio, 개발용)
pnpm gov:spike # 3개 API 동시 스모크 테스트

10. 프로젝트 구조

gov_support_mcp/
├── src/
│ ├── server.ts # MCP 서버 진입점 · 12개 Tool 핸들러 (v1.0.0)
│ ├── govSupport/
│ │ ├── env.ts # 환경변수 로더 (3개 키 검증)
│ │ ├── smesQueryEncoding.ts # Encoding 키 이중 인코딩 방지 유틸
│ │ ├── clients/
│ │ │ ├── bizinfoSupport.ts # 기업마당 API 클라이언트 ✅
│ │ │ ├── kstartupSupport.ts # K-Startup API 클라이언트 ✅
│ │ │ └── smes24PublicNotice.ts # 중소벤처24 API 클라이언트 ⚠️
│ │ ├── core/
│ │ │ ├── cache.ts # 인메모리 TTL 캐시
│ │ │ ├── dedup.ts # Jaccard 기반 중복 제거 엔진 ✅
│ │ │ └── store.ts # JSON 파일 영속성 저장소 ✅
│ │ ├── tools/
│ │ │ ├── unifiedSearch.ts # searchGovernmentSupport 구현 ✅
│ │ │ ├── compareByRegion.ts # compareByRegion 구현 ✅
│ │ │ ├── eligibility.ts # checkEligibility 구현 ✅
│ │ │ ├── documentChecklist.ts # generateDocumentChecklist 구현 ✅
│ │ │ ├── timeline.ts # buildApplicationTimeline 구현 ✅
│ │ │ ├── alertProfile.ts # manageAlertProfile 구현 ✅
│ │ │ ├── benefitHistory.ts # manageBenefitHistory 구현 ✅
│ │ │ └── draftTools.ts # draftBusinessPlan · draftSettlementReport ✅
│ │ └── types/
│ │ ├── bizinfo.ts # 기업마당 API 응답 타입
│ │ ├── kstartup.ts # K-Startup API 응답 타입
│ │ ├── smes24.ts # 중소벤처24 API 응답 타입
│ │ └── common.ts # 공통 타입 (Announcement, CompanyProfile 등)
│ └── utils/
│ └── logger.ts # 구조화 로거
├── data/ # 영속 데이터 디렉터리 (gitignore)
│ ├── alertProfiles.json # 알림 프로파일 저장소
│ ├── benefitHistory.json # 수혜 이력 저장소
│ └── companyProfiles.json # 회사 프로파일 저장소
├── scripts/
│ ├── gov-spike.ts # 3개 API 스모크 테스트
│ └── probe-smes-paths.ts # SMES24 엔드포인트 탐색 스크립트
├── tests/
│ ├── smes24PublicNotice.test.ts
│ └── smesQueryEncoding.test.ts
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
└── vitest.config.ts

11. 개발 로드맵

라이선스