Independence Merit

Provides MCP-driven access to independence merit records, official reports, and code dictionaries for ranks and affiliations.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-shinkeonkim_e-gonghun-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/your-name/projects/e-gonghun-mcp",
        "run",
        "gonghun-mcp"
      ]
    }
  }
}

This MCP Server lets you query the Independence Medal recipients’ merit lists and official records. It runs locally and can be used to fetch data like merit lists, public reports, and code lookups for ranks and affiliations, all through the Model Context Protocol with your MCP client.

How to use

You connect your MCP client (Claude Desktop or compatible tool) to the local MCP server, then request data using the available endpoints. Use the provided tools to look up the merit list, fetch individual public records, and retrieve code information for ranks and workout affiliations. You can also clear cached data to ensure you have the latest information.

How to install

Prerequisites: you need macOS or Windows, Claude Desktop, and uv version 0.4.18 or newer.

# 1) Clone the project
git clone https://github.com/국가보훈부/e-gonghun-mcp.git
cd e-gonghun-mcp

# 2) Install Python dependencies via uvx/pip (uvx is a helper for uv)
uv pip install -e .

Additional setup and configuration

Prepare environment variables by copying the sample file to a real config and filling in required values as needed.

cp .env.sample .env

Configure Claude Desktop to run the MCP server

You need to add MCP server configurations to Claude Desktop so it can launch the local server. Create a macOS configuration and a Windows configuration as shown.

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

Configure Claude Desktop to run the MCP server on Windows

Add a Windows-specific configuration to Claude Desktop to start the same MCP server from a Windows directory.

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

Available tools

get_merit_list

Query the list of independence merit records with searchable fields such as name, birth date, rank, and affiliated unit.

get_public_report

Retrieve the public official report for a specified merit record.

get_hunkuk_codes

Fetch code information for merit ranks.

get_workout_affil_codes

Fetch code information for affiliated movement groups.

clear_cache

Clear cached data to ensure up-to-date results.