韩国 Data.go.kr MCP 服务器 logo

韩国 Data.go.kr MCP 服务器

Community
Koomook

Korea public data portal (data.go.kr) API MCP servers

PublisherKoomook
Repositorydata-go-mcp-servers
LanguagePython
Forks
50
Stars
278
Available tools
0
Transport typestdio
Categories
Other
LicenseApache-2.0
Links
GitHub
  • Connect tools to AI workflows

    韩国 Data.go.kr MCP 服务器 exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 0 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    278 stars and 50 forks from the linked repository.

Korea Data.go.kr MCP Servers

한국 공공 데이터 포털(data.go.kr) API를 Model Context Protocol (MCP) 서버로 제공하는 프로젝트입니다.

GitHub PyPI License Python

목차

MCP (Model Context Protocol)란?

Model Context Protocol (MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하든, 채팅 인터페이스를 향상시키든, 사용자 정의 AI 워크플로우를 만들든, MCP는 LLM이 필요한 컨텍스트와 연결하는 표준화된 방법을 제공합니다.

MCP 서버는 Model Context Protocol을 통해 특정 기능을 노출하는 경량 프로그램입니다. Claude Desktop, Cline, Cursor, Windsurf 등의 AI 도구들이 MCP 클라이언트로서 이러한 서버와 통신할 수 있습니다.

왜 한국 공공 데이터 MCP 서버인가?

한국 정부의 공공 데이터 포털(data.go.kr)은 다양한 공공 기관의 데이터를 API로 제공합니다. 이 프로젝트는 이러한 API들을 MCP 서버로 래핑하여, AI 도구들이 한국 공공 데이터에 쉽게 접근하고 활용할 수 있도록 합니다.

주요 이점:

  • 표준화된 접근: 다양한 공공 API를 통일된 MCP 인터페이스로 사용
  • AI 도구 통합: Claude, Cline 등 AI 도구에서 직접 공공 데이터 활용
  • 간편한 설치: pip 또는 uv로 쉽게 설치 가능
  • 타입 안정성: Pydantic을 사용한 강력한 타입 검증

사용 가능한 MCP 서버

카테고리서버명설명패키지PyPI
🏢 비즈니스 정보NPS Business Enrollment국민연금공단 사업장 가입 정보 조회data-go-mcp.nps-business-enrollmentPyPI
🏢 비즈니스 정보NTS Business Verification국세청 사업자등록정보 진위확인 및 상태조회data-go-mcp.nts-business-verificationPyPI
📋 조달/계약PPS Narajangteo나라장터 입찰공고, 낙찰정보, 계약정보data-go-mcp.pps-narajangteoPyPI
💰 금융 정보FSC Financial Info금융위원회 기업 재무정보 (재무제표, 손익계산서)data-go-mcp.fsc-financial-infoPyPI
📜 공공 기록Presidential Speeches대통령기록관 연설문 조회data-go-mcp.presidential-speechesPyPI
⚗️ 안전 정보MSDS Chemical Info물질안전보건자료(MSDS) 화학물질 정보data-go-mcp.msds-chemical-infoPyPI

설치 및 설정

UV를 사용한 설치

bash
# 비즈니스 정보 서버
uv pip install data-go-mcp.nps-business-enrollment
uv pip install data-go-mcp.nts-business-verification

# 조달/계약 서버
uv pip install data-go-mcp.pps-narajangteo

# 금융 정보 서버
uv pip install data-go-mcp.fsc-financial-info

# 공공 기록 서버
uv pip install data-go-mcp.presidential-speeches

# 안전 정보 서버
uv pip install data-go-mcp.msds-chemical-info

pip을 사용한 설치

bash
# 비즈니스 정보 서버
pip install data-go-mcp.nps-business-enrollment
pip install data-go-mcp.nts-business-verification

# 조달/계약 서버
pip install data-go-mcp.pps-narajangteo

# 금융 정보 서버
pip install data-go-mcp.fsc-financial-info

# 공공 기록 서버
pip install data-go-mcp.presidential-speeches

# 안전 정보 서버
pip install data-go-mcp.msds-chemical-info

Claude Desktop 설정

Claude Desktop의 설정 파일에 MCP 서버를 추가합니다:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "data-go-mcp.nps-business-enrollment": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    "data-go-mcp.nts-business-verification": {
      "command": "uvx",
      "args": ["data-go-mcp.nts-business-verification@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    "data-go-mcp.pps-narajangteo": {
      "command": "uvx",
      "args": ["data-go-mcp.pps-narajangteo@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    "data-go-mcp.fsc-financial-info": {
      "command": "uvx",
      "args": ["data-go-mcp.fsc-financial-info@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    "data-go-mcp.presidential-speeches": {
      "command": "uvx",
      "args": ["data-go-mcp.presidential-speeches@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    },
    "data-go-mcp.msds-chemical-info": {
      "command": "uvx",
      "args": ["data-go-mcp.msds-chemical-info@latest"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

참고: @latest를 사용하면 항상 최신 버전이 실행됩니다.

Cline 설정

VS Code의 Cline 확장에서 MCP 서버를 설정합니다:

.vscode/cline_mcp_settings.json:

json
{
  "mcpServers": {
    "data-go-mcp.nps-business-enrollment": {
      "command": "python",
      "args": ["-m", "data_go_mcp.nps_business_enrollment.server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

각 서버별 사용법

국민연금공단 사업장 가입 내역 (NPS Business Enrollment)

국민연금에 가입된 사업장 정보를 조회할 수 있습니다.

환경 변수 설정

bash
export API_KEY="your-api-key-here"  # data.go.kr에서 발급받은 API 키

사용 가능한 도구

search_business: 사업장 정보 검색

  • 파라미터:
    • ldong_addr_mgpl_dg_cd: 법정동주소 광역시도 코드 (2자리)
    • ldong_addr_mgpl_sggu_cd: 법정동주소 시군구 코드 (5자리)
    • ldong_addr_mgpl_sggu_emd_cd: 법정동주소 읍면동 코드 (8자리)
    • wkpl_nm: 사업장명
    • bzowr_rgst_no: 사업자등록번호 (앞 6자리)
    • page_no: 페이지 번호 (기본값: 1)
    • num_of_rows: 한 페이지 결과 수 (기본값: 100, 최대: 100)

사용 예시

AI 도구에서 다음과 같이 요청할 수 있습니다:

"서울특별시 강남구에 있는 사업장을 검색해줘"
"삼성전자 사업장 정보를 찾아줘"
"사업자등록번호 123456으로 시작하는 사업장을 조회해줘"

국세청 사업자등록정보 진위확인 및 상태조회 (NTS Business Verification)

사업자등록정보의 진위를 확인하고 현재 상태를 조회할 수 있습니다.

환경 변수 설정

bash
export API_KEY="your-api-key-here"  # data.go.kr에서 발급받은 API 키

사용 가능한 도구

validate_business: 사업자등록정보 진위확인

  • 파라미터:
    • business_number: 사업자등록번호 (10자리, 필수)
    • start_date: 개업일자 (YYYYMMDD 형식, 필수)
    • representative_name: 대표자성명 (필수)
    • representative_name2: 대표자성명2 (외국인 한글명)
    • business_name: 상호
    • corp_number: 법인등록번호 (13자리)
    • business_sector: 주업태명
    • business_type: 주종목명
    • business_address: 사업장주소

check_business_status: 사업자등록 상태조회

  • 파라미터:
    • business_numbers: 사업자등록번호 목록 (쉼표로 구분, 최대 100개)
  • 반환값:
    • 사업자 상태: 계속사업자(01), 휴업자(02), 폐업자(03)
    • 과세유형: 일반과세자, 간이과세자 등
    • 폐업일, 과세유형 전환일 등

batch_validate_businesses: 대량 진위확인

  • 파라미터:
    • businesses_json: JSON 형식의 사업자 정보 배열 (최대 100개)
  • JSON 형식: 
    json
    [
  {
    "b_no": "1234567890",
    "start_dt": "20200101", 
    "p_nm": "홍길동",
    "b_nm": "테스트회사"
  }
]

사용 예시

AI 도구에서 다음과 같이 요청할 수 있습니다:

"사업자등록번호 123-45-67890이 2020년 1월 1일에 홍길동 대표로 등록된 것이 맞는지 확인해줘"
"사업자등록번호 123-45-67890의 현재 상태를 조회해줘"
"여러 사업자등록번호 123-45-67890, 098-76-54321의 상태를 한번에 확인해줘"

상태 코드 설명

  • 사업자 상태 코드:

    • 01: 계속사업자 (정상 영업중)
    • 02: 휴업자 (일시적 휴업)
    • 03: 폐업자 (사업 종료)

  • 과세유형 코드:

    • 01: 부가가치세 일반과세자
    • 02: 부가가치세 간이과세자
    • 기타: 면세사업자 등

개발자 가이드

개발 환경 설정

bash
# 레포지토리 클론
git clone https://github.com/Koomook/data-go-mcp-servers.git
cd data-go-mcp-servers

# UV 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 개발 의존성 설치
uv sync --dev

🚀 새로운 MCP 서버 빠르게 만들기

자동화 스크립트 사용 (권장)

가장 빠른 방법은 제공된 템플릿 생성 스크립트를 사용하는 것입니다:

bash
# 대화형 스크립트 실행
uv run python scripts/create_mcp_server.py

스크립트가 필요한 정보를 단계별로 안내하며, 몇 분 안에 새로운 MCP 서버를 생성합니다.

수동으로 템플릿 사용

bash
# Cookiecutter 설치 (필요시)
uv pip install cookiecutter

# 템플릿으로 새 서버 생성
uv run cookiecutter template/ -o src/

자세한 템플릿 사용법은 TEMPLATE_USAGE.md를 참조하세요. 전체 개발 가이드는 CONTRIBUTING.md를 참조하세요.

테스트 실행

bash
# 모든 테스트 실행
uv run pytest

# 특정 서버 테스트
uv run pytest src/nps-business-enrollment/tests/

기여하기

이 프로젝트에 기여하고 싶으시다면:

  1. 이 레포지토리를 포크하세요
  2. 새로운 기능 브랜치를 만드세요 (git checkout -b feature/new-api-server)
  3. 변경사항을 커밋하세요 (git commit -am 'Add new API server')
  4. 브랜치에 푸시하세요 (git push origin feature/new-api-server)
  5. Pull Request를 열어주세요

자세한 가이드는 CONTRIBUTING.md를 참조하세요.

라이센스

이 프로젝트는 Apache License 2.0 라이센스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

참고: 이 프로젝트는 한국 정부나 data.go.kr와 공식적으로 연관되어 있지 않습니다. 공공 데이터 사용 시 각 데이터의 이용약관을 확인하시기 바랍니다.

Installation

TypingMind
Prerequisites:

Node.js 18+

{
  "mcpServers": {
    "koomook-data-go-mcp-servers": {
      "command": "uvx",
      "args": [
        "data-go-mcp-servers"
      ]
    }
  }
}

Use 韩国 Data.go.kr MCP 服务器 MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once 韩国 Data.go.kr MCP 服务器 is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add 韩国 Data.go.kr MCP 服务器 as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the 韩国 Data.go.kr MCP 服务器 MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "koomook-data-go-mcp-servers": {
      "command": "npx",
      "args": [
        "-y",
        "data-go-mcp-servers"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the 韩国 Data.go.kr MCP 服务器 MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the 韩国 Data.go.kr MCP 服务器 MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use 韩国 Data.go.kr MCP 服务器 to help me with this task?
韩国 Data.go.kr MCP 服务器
Sure. I read it.
Here is what I found using 韩国 Data.go.kr MCP 服务器.

Frequently asked questions

What is the 韩国 Data.go.kr MCP 服务器 MCP server used for?

韩国 Data.go.kr MCP 服务器 is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use 韩国 Data.go.kr MCP 服务器 MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use 韩国 Data.go.kr MCP 服务器 with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use 韩国 Data.go.kr MCP 服务器 MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With 韩国 Data.go.kr MCP 服务器 connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect 韩国 Data.go.kr MCP 服务器 MCP to TypingMind?

韩国 Data.go.kr MCP 服务器 runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does 韩国 Data.go.kr MCP 服务器 MCP provide in TypingMind?

韩国 Data.go.kr MCP 服务器 exposes MCP capabilities that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use 韩国 Data.go.kr MCP 服务器 MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If 韩国 Data.go.kr MCP 服务器 requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all
Coding-Solo logo

Godot MCP

Coding-Solo
CommunityPopular

MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.

363
3.6K
0 tools
View details
punitarani logo

Fli - 航班搜索 MCP 服务器与库

punitarani
CommunityPopular

Google Flights MCP, CLI and Python Library

293
2.6K
0 tools
View details
ahujasid logo

Ableton Live

ahujasid
CommunityPopular

Enables control of Ableton Live music production software through a bidirectional communication system that supports track creation, MIDI editing, playback control, instrument loading, and library browsing for music composition and sound design workflows.

327
2.5K
16 tools
View details
datadaddy89 logo

Looker MCP

datadaddy89
CommunityPopular

Query Looker data with natural language using Google's Conversational Analytics API. Supports stdio (Claude Desktop) and HTTP (Cloud Run) deployment modes.

0
2.4K
17 tools
View details

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇