Server definition
- Hash
- sha256:503398a8c51223741474c19e1e0dca69426838c6b7621e2f58b30c5aed0c0b16
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "한국 공공데이터포털(data.go.kr)에 올라온 데이터셋 10만여 건을 찾아주는 읽기 전용 서버입니다. 사용자가 \"공공데이터\", \"정부/지자체 데이터\", \"data.go.kr\", \"OO API 있나\", \"OO 자료 어디서 구해\"처럼 한국 공공기관이 공개한 데이터나 API를 찾을 때 이 서버부터 쓰세요. 흐름: search(주제로 찾기) 또는 fields(컬럼명으로 찾기) → show(구조 확인) → get_preview(첫 행 보기) → download_url(받는 법). 주제+컬럼은 search(query, fields=[...]), 컬럼만이면 fields. get_preview는 표준데이터·포털 첨부는 키 없이 첫 행을 주며, 설치 확인은 get_preview로 실제 첫 행을 받을 때 끝난다. 데이터를 대신 받아 주진 않고, 어디에 뭐가 있고 어떻게 받는지를 알려줍니다. 주소 https://datagokr.dev/mcp\n활용신청·전체 다운로드·본인 키 조회(2단계)는 이 원격 서버가 하지 않습니다. 사용자가 원하면, 클로드 데스크탑 사용자에게는 https://github.com/datagokr-dev/datagokr/releases/latest/download/datagokr.mcpb 를 받아 더블클릭해 설치하라고 안내하고 (설치 후 \"공공데이터포털에 로그인해줘\" → \"활용신청해줘\"로 대화에서 처리), 클로드 웹·ChatGPT 사용자에게는 결과의 page_url에서 data.go.kr에 직접 신청·다운로드하라고 안내하세요.\nTier 2 (access applications, full downloads, keyed calls) is not done by this server: Claude Desktop users install datagokr.mcpb from the URL above; claude.ai and ChatGPT users apply on data.go.kr via page_url.\nRead-only search over Korea's public data portal (data.go.kr, ~109k datasets). Use it whenever the user wants Korean government or public-sector datasets/APIs. Flow: search or fields → show → get_preview → download_url. Topic+columns: search(query, fields=[...]); columns only: fields. get_preview gives keyless standard/attachment rows; setup requires actual rows.\n핫한/인기/유명/맛집/좋은/추천/best/popular 같은 감성·평가는 공공데이터에 없습니다. 모집단(인허가·상가·시설 목록)과 대리지표(공공이 공개한 매출·유동인구·방문객·리뷰수)로 나눠 2~3회 검색하세요. / Subjective popularity is unavailable; run 2–3 searches for base listings and public proxy metrics (sales, foot traffic, visitors, review counts).\n지역과 주제를 분리하고 지역 자료가 없으면 전국 자료(region_fallback)를 쓰세요. / Separate region from topic; use nationwide region_fallback when local data is unavailable.\ndtype/org 필터로 결과가 이상하면 필터를 빼고 다시 검색하세요. 좌표가 필요하면 fields=['위도','경도']. / Retry without dtype/org filters if results look wrong; request coordinates with fields=['위도','경도'].\n한 번 검색으로 끝내지 말고 show로 컬럼을 확인한 뒤 답하세요. / Do not stop after one search; inspect columns with show before answering.",
"tools": [
{
"description": "[공공데이터포털 검색 (datagokr)] 전체 데이터를 사용자 컴퓨터로 받는 방법을 알려줍니다. 서버가 파일을 대신 저장하진 않고 주소·요청값·절차를 돌려줍니다.\nGet client-side download instructions (URL, params, steps). The server never stores files.\n반환: access_kind, url 또는 post_url/get_url, params, version_keys(파일 버전), message(절차), page_url.\n예: '15028200 전체 JSON 받는 법', '15000001 원본 파일 다운로드 주소'",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dataset_id": {
"type": "string"
}
},
"required": [
"dataset_id"
],
"type": "object"
},
"name": "download_url",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "[공공데이터포털 검색 (datagokr)] 주제 없이 컬럼만 조건일 때(query는 빈 문자열로 고정됨). 주제가 있으면 search(query, fields=...)를 쓰세요.\nFind datasets with ALL given columns and no topic; for a topic use search(query, fields=...).\nnames에 적은 컬럼을 전부 가진 데이터셋만 나옵니다(필드명 역색인). dtype/org로 좁힐 수 있고 n은 최대 20.\n반환: id, title, org_nm, dtype, access_kind, page_url, rank, matched_fields(일치한 컬럼), last_probe_ok.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dtype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"group": {
"default": true,
"type": "boolean"
},
"n": {
"default": 10,
"type": "integer"
},
"names": {
"items": {
"type": "string"
},
"type": "array"
},
"org": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"names"
],
"type": "object"
},
"name": "fields",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "[공공데이터포털 검색 (datagokr)] 실제 첫 행 보기. STD_FILE·PORTAL_FILE(첨부 있으면)은 키 없이 첫 행을 줍니다.\nPORTAL_FILE 첨부 미리보기 실패 시 API 대체 조회에 본인 X-DataGoKr-Key가 필요할 수 있음(키는 반환·저장 안 함).\n서울·경기의 확인된 공개 경로는 키 없이 최대5행. 그 밖의 OPEN_API→request_templates, LINK→url, STD 하위행→parent_id.\nPreview standard data and portal attachments without a key. API fallback may require the caller's\nX-DataGoKr-Key. Keys are never returned or stored. API/link/subset responses give access guidance.\n반환: ok(true=처리됨, false=포털이 지금 응답 안 함→잠시 후 재시도),\ndata{columns, rows}(rows는 columns 순서의 값 배열, 최대 50컬럼·20행), total, truncated, source_note,\n또는 안내 필드(url/parent_id/request_templates/message/page_url/access_guide). 지역 API가 확인되면 service_name/request_format도 반환.\ndata가 있으면 실제 행을 받은 것.\nok=false: retry later. data means actual rows, as value arrays in columns order (up to 50 columns/20 rows).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dataset_id": {
"type": "string"
},
"n": {
"default": 5,
"type": "integer"
}
},
"required": [
"dataset_id"
],
"type": "object"
},
"name": "get_preview",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "[공공데이터포털 검색 (datagokr)] (로컬 datagokr 패키지 전용) 조회·신청·다운로드에 필요한 원본 메타데이터를 돌려줍니다. 일반 사용에서는 show를 쓰세요.\nAllowlisted raw metadata for the local datagokr client; prefer `show` for normal use.\n반환: id/title/list_title/org_nm, dtype/access_kind, page_url/external_url, parent_id, versions/version_keys,\nexamples(요청 템플릿), std_meta, api_sample. 내부 상태는 제외하고, 서버에서 신청하거나 저장하지 않습니다.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dataset_id": {
"type": "string"
}
},
"required": [
"dataset_id"
],
"type": "object"
},
"name": "record",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "[공공데이터포털 검색 (datagokr)] 주제로 공공데이터를 찾습니다. \"전국 주차장\", \"재난문자 API\", \"서울 병원 위치\"처럼 뭘 찾는지 한 줄로 주세요.\n Search Korean public datasets by topic. Give a one-line description of what you need.\n\n - 주제+컬럼 조건('서울 병원 중 위도·경도 있는 것')은 이 툴에 `fields=['위도','경도']`를 같이 주세요.\n 주제 없이 컬럼만 조건이면 `fields` 툴. / Topic + required columns: pass `fields=[...]` here.\n Columns only, no topic: use the `fields` tool.\n - 지역과 API/파일 의도는 질문에서 알아서 뽑지만, dtype(API/FILE)·org(기관)를 주면 더 정확합니다.\n - 비슷한 데이터셋은 주제별로 접어서 줍니다(group=True). 접힌 것은 group_ids의 id를 show로 펼치세요. n은 최대 20.\n\n 반환: results[{id, title, org_nm, dtype, access_kind, page_url, desc_short, top_columns, group_count, group_ids,\n access_note(접근방식 한 줄 안내)}],\n summary(잘라내기 전 후보 분포), expanded_terms(적용된 동의어), region_gap/region_fallback(지역 자료가 없을 때\n 전국·타지역 안내), scope_warning(범위 밖 질문 안내). 다음 단계: 마음에 드는 id를 show로 확인.\n \n핫한/인기/유명/맛집/좋은/추천/best/popular 같은 감성·평가는 공공데이터에 없습니다. 모집단(인허가·상가·시설 목록)과 대리지표(공공이 공개한 매출·유동인구·방문객·리뷰수)로 나눠 2~3회 검색하세요. / Subjective popularity is unavailable; run 2–3 searches for base listings and public proxy metrics (sales, foot traffic, visitors, review counts).\n지역과 주제를 분리하고 지역 자료가 없으면 전국 자료(region_fallback)를 쓰세요. / Separate region from topic; use nationwide region_fallback when local data is unavailable.\ndtype/org 필터로 결과가 이상하면 필터를 빼고 다시 검색하세요. 좌표가 필요하면 fields=['위도','경도']. / Retry without dtype/org filters if results look wrong; request coordinates with fields=['위도','경도'].\n한 번 검색으로 끝내지 말고 show로 컬럼을 확인한 뒤 답하세요. / Do not stop after one search; inspect columns with show before answering.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dtype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"fields": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"group": {
"default": true,
"type": "boolean"
},
"n": {
"default": 10,
"type": "integer"
},
"org": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"query": {
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "[공공데이터포털 검색 (datagokr)] 검색에서 고른 데이터셋의 구조와 접근 방법을 봅니다. Inspect a dataset's schema and access methods.\n반환: id, title, org_nm, category, dtype, access_kind, page_url, portal_updated, columns(최대 50),\noperations, operation_names, examples, n_versions, version_keys(최신 3개), note, access_guide(인증·받는 절차),\ntruncated(잘린 항목과 전체 개수), more(후속 조회법). 응답은 약 20KB 이내로 잘림.\noperations가 많은 API는 show(id, operation='기능명 또는 operation_seq')로 한 기능만 전체 보기.\nResponses are trimmed to about 20KB; select an operation by name or sequence for its full fields.\n쓸 만하면 get_preview로 실제 첫 행을 확인하세요.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dataset_id": {
"type": "string"
},
"operation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"dataset_id"
],
"type": "object"
},
"name": "show",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:503398a8c51223741474c19e1e0dca69426838c6b7621e2f58b30c5aed0c0b16 | sha256sum