독립유공자 공훈록 MCP 서버

Overview

基本能力

产品定位

e-gonghun-mcp 是一个专门用于查询韩国独立有功者功勋录和功绩调书的 MCP 服务，旨在为 Claude Desktop 提供相关历史数据的查询能力。

核心功能

独立有功者功勋录列表查询
独立有功者功绩调书查询
勋格、运动系列等代码信息提供

适用场景

历史研究人员查询独立有功者信息
教育工作者获取历史教学资料
公众了解韩国独立运动历史

工具列表

get_merit_list - 查询独立有功者功勋录列表
支持按姓名、出生日期、勋格、运动系列等条件搜索
get_public_report - 查询独立有功者功绩调书
get_hunkuk_codes - 查询勋格代码信息
get_workout_affil_codes - 查询运动系列代码信息
clear_cache - 清除缓存数据

常见问题解答

需要确保已安装最新版本的 Claude Desktop
需要正确配置环境变量
需要确保 uv 版本在 0.4.18 或以上

使用教程

使用依赖

macOS 或 Windows 操作系统
Claude Desktop 最新版本
uv 0.4.18 或以上版本

macOS 环境设置

# 使用 Homebrew 安装
brew install uv

# 或手动下载:
# uv: https://docs.astral.sh/uv/

Windows 环境设置

# 使用 winget 安装
winget install --id=astral-sh.uv -e

# 或手动下载:
# uv: https://docs.astral.sh/uv/

安装教程

# 克隆项目
git clone https://github.com/국가보훈부/e-gonghun-mcp.git
cd e-gonghun-mcp

# 安装包
uv pip install -e .

环境变量设置

将 .env.sample 文件复制为 .env 并填写必要设置

cp .env.sample .env

调试方式

macOS 设置

打开设置文件:

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

添加以下设置:

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

Windows 设置

打开设置文件:

code $env:AppData\Claude\claude_desktop_config.json

添加以下设置:

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

重启 Claude Desktop

许可证

该项目遵循 MIT 开源许可条款。