Skip to main content
Glama
독립유공자 공훈록 MCP 서버

독립유공자 공훈록 MCP 서버

by kokoa-tools

Independence Meritorious Service Merit Record MCP Server

This is an MCP (Model Context Protocol) server that allows you to search the records of merit and records of achievements of independence activists in the Electronic Archives of the Ministry of Patriots and Veterans Affairs.

Preparation

Before you begin, you will need the following tools:

  • macOS or Windows

  • Claude Desktop Latest Version

  • uv 0.4.18 or higher (check with uv --version )

macOS Preferences

# Homebrew 사용
brew install uv

# 또는 직접 다운로드:
# uv: https://docs.astral.sh/uv/

Windows Preferences

# winget 사용
winget install --id=astral-sh.uv -e

# 또는 직접 다운로드:
# uv: https://docs.astral.sh/uv/

Related MCP server: MCP Server Legifrance

How to install

# 프로젝트 복제
git clone https://github.com/국가보훈부/e-gonghun-mcp.git
cd e-gonghun-mcp

# 패키지 설치
uv pip install -e .

Setting environment variables

Copy .env.sample file to .env and fill in the necessary settings.

cp .env.sample .env

How to use Claude Desktop

To use this tool on Claude Desktop, you need the following settings:

macOS Settings

  1. Open the settings file:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. Add the following settings:

{
  "mcpServers": {
    "e_gonghun_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/사용자이름/projects/e-gonghun-mcp",
        "run",
        "gonghun-mcp"
      ]
    }
  }
}

Windows Settings

  1. Open the settings file:

code $env:AppData\Claude\claude_desktop_config.json
  1. Add the following settings:

{
  "mcpServers": {
    "e_gonghun_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\사용자이름\\projects\\e-gonghun-mcp",
        "run",
        "gonghun-mcp"
      ]
    }
  }
}
  1. Restart Claude Desktop.

function

  • View the list of meritorious deeds of independence activists

  • Inquiry into the records of meritorious deeds of independence activists

  • Provides code information such as training and sports series

How to use API

The Model Context Protocol enables the following tools:

  1. get_merit_list - Get the list of merits of independence activists

    • Searchable by name, date of birth, grade, athletic background, etc.

  2. get_public_report - View the records of meritorious deeds of independence activists

  3. get_hunkuk_codes - Gets information about hunkuk codes

  4. get_workout_affil_codes - Get workout affil code information

  5. clear_cache - clears cached data

Example of use

Ask Claude Desktop the following questions:

3.1운동을 이천에서 참여한 독립유공자 목록을 가져와줘

How it works

Interacting with Claude Desktop via the Model Context Protocol goes like this:

  1. Server Discovery : Claude Desktop connects to the configured MCP servers on startup and checks the capabilities of each server.

  2. Protocol handshake : Select an appropriate MCP server and negotiate capabilities via the protocol, then request data or operations from the server.

  3. Extending Model Context : The MCP server provides additional context and data to the Claude model to enable it to generate more accurate and detailed responses.

  4. Interaction Flow : When you make a query request in Claude Desktop, the MCP server processes the data and returns the results.

  5. Security : The MCP server provides only specific functionality, runs locally, and requires user confirmation for critical operations.

License

MIT License

Copyright (c) 2024

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


This repository was created using Anthropic's Claude 3.7 Sonnet.

Available Tools

5 tools
clear_cacheB

캐시된 데이터를 모두 초기화합니다

Inputs: no named parameters.

get_hunkuk_codesC

훈격 코드 정보를 조회합니다

Inputs: no named parameters.

get_merit_listC

독립유공자 공훈록 목록을 조회합니다

Inputs: page_index, count_per_page, mng_no, name_ko, +11 more.

get_public_reportC

독립유공자 공적조서를 조회합니다

Inputs: page_index, count_per_page, mng_no, name_ko, +12 more.

get_workout_affil_codesC

운동계열 코드 정보를 조회합니다

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: cache management, code lookups for hunkuk and workout affiliation, and two types of merit record retrieval (list and public report). No ambiguity or overlap exists between these functions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with 'get_' or 'clear_' prefixes, using snake_case throughout. The naming is predictable and readable across all five tools.

    Tool Count5/5

    With 5 tools, this server is well-scoped for its domain of Korean independence merit records. Each tool serves a specific, necessary function without bloat or redundancy.

    Completeness4/5

    The toolset covers core read operations (list, report, code lookups) and cache management well. A minor gap exists in write/update capabilities (e.g., no create or modify tools), but this is reasonable for a likely read-only public data service.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers