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/

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

Open the settings file:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the following settings:

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

Windows Settings

Open the settings file:

code $env:AppData\Claude\claude_desktop_config.json

Add the following settings:

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

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:

get_merit_list - Get the list of merits of independence activists
- Searchable by name, date of birth, grade, athletic background, etc.
get_public_report - View the records of meritorious deeds of independence activists
get_hunkuk_codes - Gets information about hunkuk codes
get_workout_affil_codes - Get workout affil code information
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:

Server Discovery : Claude Desktop connects to the configured MCP servers on startup and checks the capabilities of each server.
Protocol handshake : Select an appropriate MCP server and negotiate capabilities via the protocol, then request data or operations from the server.
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.
Interaction Flow : When you make a query request in Claude Desktop, the MCP server processes the data and returns the results.
Security : The MCP server provides only specific functionality, runs locally, and requires user confirmation for critical operations.

License

MIT License

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.

독립유공자 공훈록 MCP 서버

Integrations