E Gonghun (Korean Military Service Records)

🚀 獨立有功者榮譽記錄 MCP 服務器

本 MCP 服務器主要用於查詢獨立有功者的榮譽記錄，能夠根據指定條件獲取相關榮譽信息，還可生成詳細的公抁報告，同時提供 RESTful API 進行程序化操作，為相關數據的管理和使用提供了便利。

🚀 快速開始

在使用本服務器之前，請先做好準備工作，完成安裝、環境變量配置等步驟，以下是詳細說明。

✨ 主要特性

• 查詢獨立有功者榮譽記錄：通過指定條件獲取相關榮譽記錄信息。
• 生成公抁報告：根據提供的數據生成詳細的公抁報告。
• API 接口：提供 RESTful API 用於程序化操作。

📦 安裝指南

克隆倉庫

在終端中運行以下命令以克隆此倉庫：

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 使用方法

接口說明

查詢榮譽記錄

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

生成公抁報告

POST /reports
Content-Type: application/json

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

基礎用法

查詢獨立有功者榮譽記錄

在終端中運行以下命令以查詢特定獨立有功者的榮譽記錄：

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

生成公抁報告

使用以下命令生成年度公抁報告：

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

🔧 技術細節

工作原理

1. 服務器發現：客戶端通過網絡發現 MCP 服務器。
2. 協議協商：客戶端與服務器之間進行協議版本協商。
3. 命令執行：根據協商結果，客戶端發送具體命令並由服務器處理。

📄 許可證

MIT License

版權 (c) 2024

准許任何人免費使用、複製、修改、合併、發佈、分發、 sublicense 和/或出售此軟件及其關聯的文檔文件（“軟件”），且無限制，包括但不限於為任何目的而使用的權利。

軟件按“原樣”提供，不做任何形式的保證，包括但不限於對適銷性、適合特定用途和非侵權性的保證。在因合同、 TORT 或其他行為導致的任何主張、損害或其他責任中，作者或版權持有者概不負責。

此倉庫使用 Anthropic 的 Claude 3.7 聲調模型編寫。