独立功绩服务功绩记录 MCP 服务器

这是可以在爱国者和退伍军人事务部电子档案中搜索独立运动家功绩记录和业绩记录的MCP（模型上下文协议）服务器。

准备

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

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/

Related MCP server: HR MCP Server

如何安装

# 프로젝트 복제
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 设置

打开设置文件：

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。

功能

查看独立运动者功绩列表
独立运动者功绩记录调查
提供训练和运动系列等代码信息

如何使用API

模型上下文协议支持以下工具：

get_merit_list - 获取独立活动家功绩列表
- 可按姓名、出生日期、年级、运动背景等进行搜索。
get_public_report - 查看独立运动者的功绩记录
get_hunkuk_codes - 获取有关 hunkuk 代码的信息
get_workout_affil_codes - 获取锻炼附属代码信息
clear_cache清除缓存数据

使用示例

向 Claude Desktop 询问以下问题：

3.1운동을 이천에서 참여한 독립유공자 목록을 가져와줘

工作原理

通过模型上下文协议与 Claude Desktop 交互如下：

服务器发现：Claude Desktop 在启动时连接到已配置的 MCP 服务器并检查每个服务器的功能。
协议握手：选择合适的 MCP 服务器并通过协议协商功能，然后向服务器请求数据或操作。
扩展模型上下文：MCP 服务器为 Claude 模型提供额外的上下文和数据，使其能够生成更准确、更详细的响应。
交互流程：当您在Claude Desktop中发出查询请求时，MCP服务器会处理数据并返回结果。
安全性：MCP 服务器仅提供特定功能，在本地运行，并且需要用户确认关键操作。

执照

MIT 许可证

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

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

该存储库是使用 Anthropic 的 Claude 3.7 Sonnet 创建的。

독립유공자 공훈록 MCP 서버