E Gonghun (Korean Military Service Records)

🚀 独立有功者荣誉记录 MCP サーバー

このサーバーは、独立した有功者の荣誉記録を管理し、関連する情報を提供するための MCP サーバーです。特定の条件を指定して荣誉記録を取得したり、公抁報告書を生成したりすることができます。

🚀 クイックスタート

準備事項

サーバーを起動する前に、以下のツールと環境がインストールされていることを確認してください。

• オペレーティングシステム：macOS または Windows
• Python：Python 3.8 以上を使用することを推奨します。
• pip：パッケージ管理に使用されます。
• Git：コードリポジトリのクローンに使用されます。

インストール

リポジトリのクローン

ターミナルで以下のコマンドを実行して、このリポジトリをクローンします。

git clone https://github.com/your-repository.git
cd independent-contributors-honors-mcp-server

依存関係のインストール

以下のコマンドを使用して、必要な Python パッケージをインストールします。

uv pip install -e .

環境変数の設定

env-sample ファイルをコピーして .env という名前に変更します。

cp env-sample .env

その後、必要に応じて .env ファイルを編集して環境を設定します。

Claude Desktop の使用方法

macOS の設定

1. ターミナルを開き、以下のコマンドを実行します。

echo '{
  "ai": {
    "client": "claude-sonnet",
    "model": "anthropic/claude-3-sonnet",
    "api_key_path": "~/.config/anthropic/keys.json"
  },
  "log_level": "INFO"
}' > $(xdg-user-docdir)/Claude/settings.json

2. ~/.config/anthropic/keys.json ファイルを開き、API キーを追加します。

{
  "ANTHROPIC_API_KEY": "your-api-key-here"
}

Windows の設定

1. コマンドプロンプトを開き、以下のコマンドを実行します。

echo {
  ^
  "ai": {
    ^
    "client": "claude-sonnet",
    ^
    "model": "anthropic/claude-3-sonnet",
    ^
    "api_key_path": "%APPDATA%\Claude\keys.json"
  },
  ^
  "log_level": "INFO"
} > "%ProgramData%\Claude\settings.json"

2. C:\Users\<username>\AppData\Roaming\Claude\keys.json ファイルを開き、API キーを追加します。

{
  "ANTHROPIC_API_KEY": "your-api-key-here"
}

✨ 主な機能

• 独立有功者の荣誉記録の照会：特定の条件を指定して、関連する荣誉記録情報を取得することができます。
• 公抁報告書の生成：提供されたデータに基づいて、詳細な公抁報告書を生成することができます。
• API インターフェース：RESTful API を提供し、プログラムによる操作を可能にします。

💻 使用例

基本的な使用法

独立有功者の荣誉記録の照会

ターミナルで以下のコマンドを実行して、特定の独立有功者の荣誉記録を照会します。

independent-contributors-honors-mcp-server get-honors --name "李大" --year 2023

公抁報告書の生成

以下のコマンドを使用して、年度の公抁報告書を生成します。

independent-contributors-honors-mcp-server generate-report --year 2023

高度な使用法

API を使用した操作

このサーバーは RESTful API を提供しており、以下のように API を使用して操作することができます。

荣誉記録の照会

GET /honors?name={name}&year={year}

公抁報告書の生成

POST /reports
Content-Type: application/json

{
  "data": {
    "entries": [ ... ]
  }
}

🔧 技術詳細

動作原理

1. サーバーの発見：クライアントはネットワークを介して MCP サーバーを発見します。
2. プロトコルの交渉：クライアントとサーバーの間でプロトコルバージョンの交渉が行われます。
3. コマンドの実行：交渉の結果に基づいて、クライアントは具体的なコマンドを送信し、サーバーが処理します。

📄 ライセンス

MIT ライセンス

Copyright (c) 2024

このソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」）を無制限に使用、コピー、変更、統合、公開、配布、サブライセンス、および/または販売することを許可します。

ソフトウェアは「現状のまま」提供され、商品性、特定の目的への適合性、および非侵害性を含む、いかなる形式の保証も行われません。契約、不法行為、またはその他の行為に起因するいかなる請求、損害、またはその他の責任についても、著者または著作権者は一切の責任を負いません。

このリポジトリは Anthropic の Claude 3.7 ソネットモデルを使用して作成されています。