Skip to main content
Glama
datagokr-dev

datagokr

by datagokr-dev
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DATAGOKR_API_KEYNo공공데이터포털 API 키 (odcloud 조회에 사용, 미리보기 시 원격 서버로 전송될 수 있음)
DATAGOKR_REMOTE_URLNo원격 검색·미리보기 MCP 서버 주소 (기본값: https://159-223-75-71.sslip.io/mcp)
DATAGOKR_DOWNLOAD_DIRNo원문 다운로드 기본 폴더 (기본값: ~/datagokr)
DATAGOKR_SESSION_FILENo포털 로그인 세션 파일 경로 (기본값: ~/.config/datagokr/session.json)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
searchB

주제로 공공데이터를 원격 검색합니다. Search the remote catalog by topic. query: 자연어 / topic; n: 1~20; dtype: FILE/API/STD; org: 기관명 / provider; fields: 모두 필요한 컬럼 / required columns. 반환 / Returns: ranked id, title, org_nm, access_kind, page_url, matched_fields. 예시 / Example: query='전국 주차장'.

showA

검색한 데이터셋의 구조·사용법을 확인합니다. Inspect dataset metadata before use. 반환 / Returns: title, org_nm, access_kind, columns, operations, examples, page_url. dataset_id는 검색 결과의 id입니다. Use the id from search; use get for actual rows.

fieldsA

지정 컬럼을 모두 가진 데이터셋을 찾습니다. Find datasets matching ALL named columns. names 예시 / Example: ['위도', '경도']; n: 1~20; dtype: FILE/API/STD; org: 기관명. 반환은 search와 같은 메타데이터입니다. Returns ranked metadata as in search.

previewB

원격 서버에서 첫 행·접근 안내를 조회합니다. Preview up to 20 rows remotely. 반환 / Returns: access_kind, data.columns/rows, total or access instructions. 설정된 본인 키는 원격 서버의 X-DataGoKr-Key 헤더로 전송됩니다. The configured API key is sent to the remote server in X-DataGoKr-Key. 신청·저장 없음 / No application or file saving.

fetchA

본인 로컬 키로 odcloud 첫 n행을 조회합니다. Fetch rows locally with DATAGOKR_API_KEY. version 생략 시 최신 / latest version by default. 반환 / Returns: API data or request_templates; status_code=401 means access must be requested. STD_FILE은 get/download. 활용신청·파일 저장은 하지 않습니다. Does not apply for access or save files.

getA

접근방식에 따라 첫 행·링크·API 템플릿을 돌려줍니다. Get rows, links or API templates. PORTAL_FILE 401은 기본적으로 신청 없이 원문 파일 저장으로 폴백합니다. 활용신청까지 하려면 사용자가 명시적으로 허락한 경우에만 no_apply=False 를 넘기세요 (본인 계정으로 신청이 나갑니다). By default no application is submitted on 401; pass no_apply=False only with the user's explicit consent. probe=True는 신청·파일 저장 없이 확인. probe checks access without applying or saving files. 반환 / Returns: access_kind with data, url, request_templates or files (local paths).

applyA

본인의 저장된 포털 세션으로 활용신청을 제출합니다. Submit access applications with saved login. ids: 1~50개 데이터셋 id; purpose: 활용 목적 / intended use. 로그인: datagokr login. 반환 / Returns: id, status, portal_status, page_url; manual means login is required. 쿠키는 포털에만 전송됩니다. Cookies are sent only to the portal.

downloadA

원문을 이 컴퓨터에 저장합니다(같은 경로는 덮어씀). Save originals locally, overwriting the same path. version 또는 all_versions 중 하나 / choose version or all_versions; out: 이번 저장 폴더, 기본 DATAGOKR_DOWNLOAD_DIR / destination directory; utf8: CSV UTF-8 변환본 추가. probe=True는 저장 없이 확인합니다. probe checks without saving. 반환 / Returns: files with path, version, optional utf8_path, or an external url; STD_FILE is saved as a full CSV.

login_statusA

저장된 포털 세션의 유효성을 확인합니다. Check whether the saved portal login is valid. 반환 / Returns: authenticated, message. 세션이 없거나 만료되면 datagokr login 안내. Missing or expired sessions require datagokr login. Keys and cookies are never returned.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources