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) 도구로 노출하고, CLI/Node.js 클라이언트에서 자연어로 조회할 수 있는 예제 프로젝트입니다.

구성

server.py: FastMCP 기반 Python 서버 및 자연어 CLI
client.mjs: Node.js용 MCP 샘플 클라이언트 (stdio로 Python 서버를 자동 실행)
requirements.txt: Python 의존성 목록
package.json: Node.js 의존성 및 실행 스크립트

사전 준비

Python 3.12+ / Node.js 18+ 설치 (Windows의 경우 python 또는 py -3 명령이 동작해야 합니다)

Python 환경 설정 및 실행

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# CLI 자연어 질의 모드
python server.py
# 또는 한 번만 실행
python server.py --query "서울 소상공인 사업 알려줘"

# MCP stdio 서버 모드
python server.py --stdio

Node.js 클라이언트 사용 (원클릭 설치/호출)

npm install
npm run mcp -- --region=서울 --target=소상공인 --keywords=AI

npm run mcp는 처음 실행 시 가상환경(.venv)을 자동으로 만들고 requirements.txt를 설치한 뒤 Python MCP 서버(python server.py --stdio)를 띄워 search_bizinfo 도구를 호출합니다. 한 번 설정되면 이후에도 같은 명령 하나로 바로 실행할 수 있습니다.

기본적으로 패키지에 포함된 데모 API 키를 사용합니다. 자체 키를 쓰고 싶다면 .env 파일에 BIZINFO_API_KEY=<나의 키>를 추가하세요.

자연어 전용 CLI (`bizinfo`)

전역 설치 후 자연어 질문을 그대로 입력할 수도 있습니다.

npm install -g @kwangdss/bizinfo-mcp
bizinfo "광주 ai 사업 찾아줘"

# 로컬 클론 없이 one-shot 실행 (npx)
npx @kwangdss/bizinfo-mcp "광주 ai 사업 찾아줘"

bizinfo 명령은 자연어 문장을 받아 MCP의 search_bizinfo_natural 도구를 호출합니다. 문장 안에 지역/대상/키워드가 섞여 있어도 자동으로 분석해 결과를 보여줍니다.

GitHub 업로드 절차 예시

git init
git add .
git commit -m "Add Bizinfo MCP server"
# GitHub에서 새 저장소 생성 후 아래처럼 연결
git remote add origin https://github.com/<USERNAME>/bizinfo-mcp.git
git push -u origin main

npm Registry 배포

패키지 이름이 @kwangdss/bizinfo-mcp로 설정되어 있으므로, npm 계정에서 스코프 권한을 만든 뒤 아래처럼 공개 배포하면 됩니다.

npm login
npm publish --access public

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

Node.js 환경에서 MCP 설치/활용

본 저장소는 @modelcontextprotocol/sdk를 이용해 stdio 기반 서버를 호출합니다.
다른 MCP 클라이언트를 사용하려면 npm install 후 node client.mjs 또는 자체 코드에서 StdioClientTransport를 활용하십시오.

라이선스

MIT

@kwangdss/bizinfo-mcp