e-gonghun

This MCP server lets you look up the Independent Heroes Merits Register and related service sheets using a Model Context Protocol client. It exposes structured endpoints that let you search for individual merit records, view public notes, and retrieve code lists for ranks and athletic affiliations, all from your local environment.

How to use

You will run a local MCP server with the uv tool and connect your MCP client to it. The server provides endpoints to list merit records, fetch individual public reports, and query code lists for ranks and athletic affiliations. Use your MCP client to select the corresponding server configuration, then issue queries such as asking for records from a specific movement era or filtering by birthplace or rank. When a query is sent, the client negotiates capabilities with the local MCP server, which returns structured results ready for display in your UI.

How to install

# Prerequisites
# macOS or Windows
# Ensure uv is installed and available in your PATH

# Install Python dependencies through uv runtime
uv pip install -e .

# Setup environment (copy sample env if you need to customize)
cp .env.sample .env
```}]} ,{

Additional configuration and notes

Two local MCP startup configurations are provided to accommodate macOS-like and Windows-like environments. You run the MCP server from your local machine and connect Claude Desktop or any compatible MCP client.

Tools and endpoints

This MCP server exposes the following functions to your MCP client:

Available tools

get_merit_list

Fetches the list of Independent Merits records with searchable fields such as name, birthdate, rank, and movement affiliation.

get_public_report

Retrieves the public merit report for a specified individual.

get_hunkuk_codes

Returns the code information for merit ranks.

get_workout_affil_codes

Returns the code information for athletic affiliations.

clear_cache

Clears any cached data to ensure fresh results on subsequent requests.