Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@kwangdss/bizinfo-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Bizinfo MCP Server

기업마당 지원사업 데이터를 Model Context Protocol(MCP) 도구로 노출하고, Node.js CLI나 다른 MCP 클라이언트에서 자연어로 바로 조회할 수 있는 예제 프로젝트입니다.

구성 파일

server.mjs – MCP stdio 서버 (Node.js 전용)
bin/bizinfo.mjs – npx/전역 명령으로 사용하는 자연어 CLI
client.mjs – MCP 클라이언트 예시 (Node.js에서 서버를 stdio로 연결)
lib/ – 자연어 파서 및 공통 로직 모음
package.json – 의존성과 실행 스크립트 정의

빠른 시작 (설치 없이 실행)

npx @kwangdss/bizinfo-mcp "광주 소상공인 사업 알려줘"

처음 실행 시 패키지에 포함된 데모 API 키를 사용해 바로 결과를 보여줍니다. 자체 키를 쓰고 싶다면 현재 작업 디렉터리에 아래와 같은 .env 파일을 만들어 두면 됩니다.

BIZINFO_API_KEY=나의_API_키

전역 설치해서 사용하기

npm install -g @kwangdss/bizinfo-mcp
bizinfo "서울 창업 사업 알려줘"

전역 명령 bizinfo는 자연어 문장을 분석해 지역/대상/키워드를 추출하고, 내부적으로 MCP 도구 search_bizinfo_natural을 호출해 최대 10건을 요약해 줍니다.

로컬 개발 및 예제 클라이언트

git clone https://github.com/<USERNAME>/bizinfo-mcp.git
cd bizinfo-mcp
npm install

# 1) MCP 서버 직접 실행 (stdio)
node server.mjs --stdio   # MCP 클라이언트가 stdio로 연결

# 2) 자연어 한 번만 실행
node server.mjs --query "부산 소상공인 지원사업 알려줘"

# 3) MCP 클라이언트 예시
npm run mcp -- --region=서울 --target=소상공인

npm run mcp 스크립트는 Node 서버(server.mjs --stdio)를 자동으로 띄운 뒤 MCP 도구를 호출합니다.

배포

npm login
npm publish --access public

배포가 완료되면 누구나 npx @kwangdss/bizinfo-mcp "질문" 또는 npm install -g @kwangdss/bizinfo-mcp로 사용할 수 있습니다.

라이선스

MIT