J그랜츠 보조금 검색 MCP — torchi PoC

디지털청의 J그랜츠 공개 API를 Notion 등의 MCP 클라이언트에서 이용하기 위한 읽기 전용 원격 MCP입니다.

디지털청의 공개 샘플 digital-go/jgrants-mcp-server를 기반으로, Sliplane 상시 운영용 인증, 헬스체크, 컨테이너 구성, 출력량 제어를 추가했습니다.

제공 도구

• ping — 연결 확인

• search_subsidies — 키워드, 지역, 업종, 종업원 수, 이용 목적으로 검색

• get_subsidy_overview — 마감 기간·상한 금액별 집계

• get_subsidy_detail — 상세 및 첨부 자료 목록 조회

• get_file_content — 선택한 첨부 자료만 Markdown으로 변환

검색 결과에는 공식 J그랜츠 URL과 출처를 첨부합니다. 획득한 정보는 참고용이며, 신청 전에 공식 페이지의 최신 정보를 확인하시기 바랍니다.

Related MCP server: koko-call-mcp

원격 구성

Notion
  -> HTTPS + Bearer token
  -> Caddy gateway（公開）
  -> FastMCP server（Sliplane内部のみ）
  -> Jグランツ公開API

• /health는 모니터링용으로 인증 없이 공개합니다.

• /mcp는 Gateway와 MCP 본체 양쪽에서 동일한 Bearer token을 검증합니다.

• Token은 Sliplane의 Secret 환경 변수에만 저장하며, GitHub나 로그에는 넣지 않습니다.

• 첨부 자료는 MCP 본체의 임시 영역에 저장되며, 필요한 파일만 본문으로 반환합니다.

로컬 개발

Python 3.10 이상과 uv를 사용합니다.

uv sync
uv run pytest
JGRANTS_REQUIRE_AUTH=0 uv run python -m jgrants_mcp_server

인증付きのDocker構成は次のとおりです。

cp .env.example .env
# .envのMCP_AUTH_TOKENを32文字以上のランダム値へ変更
docker compose up --build
curl http://localhost:8080/health
curl -i http://localhost:8080/mcp

미인증 /mcp는 HTTP 401을 반환합니다.

Sliplane 설정

동일한 GitHub 리포지토리에서 2개의 서비스를 생성합니다.

jgrants-mcp

• Dockerfile: Dockerfile

• 공개: 오프

• Healthcheck: /health

• 환경 변수:

  • JGRANTS_HOST=0.0.0.0

  • JGRANTS_PATH=/mcp

  • JGRANTS_REQUIRE_AUTH=1

  • MCP_AUTH_TOKEN=<secret>

  • PORT=8000

jgrants-mcp-gateway

• Dockerfile: gateway/Dockerfile

• 공개: 온

• Healthcheck: /health

• 환경 변수:

  • MCP_AUTH_TOKEN=<same secret>

  • UPSTREAM_URL=http://jgrants-mcp.internal:8000

main으로의 push를 자동 배포 대상으로 설정합니다. Notion에는 Gateway의 공개 URL에 /mcp를 붙인 URL과 Bearer token을 등록합니다.

라이선스 및 출처

코드는 MIT License입니다. J그랜츠 API 이용은 J그랜츠 API 이용 약관을 따릅니다. 공개·전용 시에는 J그랜츠를 출처로 명시해 주시기 바랍니다.