独立有功者功勋录 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

1. 添加如下配置：

{
  "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

1. 添加如下配置：

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

1. 重启Claude Desktop。

功能

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

API 使用说明

通过Model Context Protocol，您可以使用以下功能：

1. get_merit_list - 查询独立有功者功勋录列表
   • 可以根据姓名、出生日期、勋级、运动系列等进行搜索
2. get_public_report - 查询独立有功者功绩报告
3. get_hunkuk_codes - 查询勋级代码信息
4. get_workout_affil_codes - 查询运动系列代码信息
5. get_clear_cache - 清除缓存的数据

使用示例

在Claude Desktop中尝试这样提问：

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

工作原理

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

1. 发现服务器：Claude Desktop启动时会连接到配置好的MCP服务器，并检查每个服务器的功能。
2. 协议握手：选择合适的MCP服务器后，通过协议协商功能，然后向服务器请求数据或执行任务。
3. 模型上下文扩展：MCP服务器为Claude模型提供额外的上下文和数据，使得能够生成更准确详尽的回答。
4. 交互流程：当Claude Desktop执行查询请求时，MCP服务器处理数据并返回结果。
5. 安全性：MCP服务器仅提供特定功能，并且只在本地运行；对于重要操作需要用户确认。

许可证

MIT License

版权所有 (c) 2024

特此授予任何人免费获取本软件及其相关文档文件（“软件”）副本的权利，不受限制地使用、复制、修改、合并、发布、分发、再许可以及/或者出售软件副本，并允许向其提供软件的人也这样做，但须遵守以下条件：

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

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

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