独立有功者公訓録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の設定

設定ファイルを開く：

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の使い方

Model Context Protocolでは、次のツールを使用できます。

get_merit_list - 独立有功者公訓録のリストを照会する
- 名前、生年月日、訓練、運動系列などで検索可能
get_public_report - 独立有功者の公的助言を照会する
get_hunkuk_codes - 訓練コード情報を照会する
get_workout_affil_codes - 運動系列コード情報を照会する
clear_cache - キャッシュされたデータを初期化する

使用例

Claude Desktopで次のように質問してください。

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

動作原理

Model Context Protocol による Claude Desktop の相互作用は次のように行われます。

サーバーの検出：Claude Desktopは起動時に設定されたMCPサーバーに接続し、各サーバーの機能を確認します。
プロトコルハンドシェイク：適切なMCPサーバーを選択し、プロトコルを介した機能ネゴシエーションの後にサーバーにデータまたは操作を要求します。
モデルコンテキスト拡張：MCPサーバーはClaudeモデルに追加のコンテキストとデータを提供し、より正確で詳細な応答を生成できます。
対話フロー：Claude Desktopでクエリ要求を実行すると、MCPサーバーはデータを処理して結果を返します。
セキュリティ：MCPサーバーは特定の機能のみを提供し、ローカルでのみ実行され、重要な操作にはユーザーの確認が必要です。

ライセンス

MITライセンス

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRING IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WI DEALINGS IN THE SOFTWARE.

このリポジトリは Anthropic の Claude 3.7 Sonnet を使用して作成されました。

독립유공자 공훈록 MCP 서버

Integrations