AI导哈

独立功臣记录查询服务

一个基于MCP协议的服务，用于查询国家报勋部电子资料馆的独立功臣功勋录及功绩记录。

  • by kokoa-tools
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shinkeonkim/e-gonghun-mcp

使用说明

独立有功者功勋录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. 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许可证

版权所有（c）2024

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

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

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

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

相关 MCP