独立有功者功勋录 MCP 服务器

这是一个可以查询国家报勋处功勋电子史料馆的独立有功者功勋录及功绩调查书的 MCP (Model Context Protocol) 服务器。

准备事项

开始之前，您需要以下工具：

• macOS 或 Windows
• Claude Desktop 最新版本
• uv 0.4.18 以上 (使用 uv --version 命令确认)

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

在 Claude Desktop 中使用方法

要在 Claude Desktop 中使用此工具，需要进行以下设置：

macOS 设置

1. 打开配置文件：

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

2. 添加以下设置：

{
  "mcpServers": {
    "e_gonghun_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/用户名/projects/e-gonghun-mcp",
        "run",
        "gonghun-mcp"
      ]
    }
  }
}

Windows 设置

1. 打开配置文件：

code $env:AppData\Claude\claude_desktop_config.json

2. 添加以下设置：

{
  "mcpServers": {
    "e_gonghun_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\用户名\\projects\\e-gonghun-mcp",
        "run",
        "gonghun-mcp"
      ]
    }
  }
}

3. 重启 Claude Desktop。

功能

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

API 使用方法

可以通过 Model Context Protocol 使用以下工具：

1. get_merit_list - 查询独立有功者功勋录列表
   • 可以通过姓名、出生年月日、勋格、运动系列等进行搜索
2. get_public_report - 查询独立有功者功绩调查书
3. get_hunkuk_codes - 查询勋格代码信息
4. get_workout_affil_codes - 查询运动系列代码信息
5. clear_cache - 初始化缓存数据

使用示例

在 Claude Desktop 中尝试以下提问：

请获取在利川参与三一运动的独立有功者名单

运作原理

通过 Model Context Protocol 进行的 Claude Desktop 交互过程如下：

1. 服务器发现: Claude Desktop 在启动时连接到设置的 MCP 服务器，并确认每个服务器的功能。
2. 协议握手: 选择合适的 MCP 服务器，通过协议协商功能后，向服务器请求数据或操作。
3. 模型上下文扩展: MCP 服务器向 Claude 模型提供额外的上下文和数据，使其能够生成更准确和详细的响应。
4. 交互流程: 在 Claude Desktop 中执行查询请求时，MCP 服务器处理数据并返回结果。
5. 安全: MCP 服务器仅提供特定功能，仅在本地运行，重要操作需要用户确认。

许可证

MIT License

Copyright (c) 2024

特此授予任何人免费获得本软件及相关文档文件（“软件”）副本的许可，可以不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须满足以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他方面，由本软件或本软件的使用或其他交易引起、产生或与之相关。

---

本仓库使用 Anthropic 的 Claude 3.7 Sonnet 编写。