# MintHCM — Open-Source HCM (MCP/A2A Claims)

> MintHCM is an open-source HCM platform with AI-agent positioning (MCP/WebMCP mentioned). Includes a Docker Compose stack (app + MySQL + Elasticsearch).

## Install

Copy the content below into your project:

## Quick Use

```bash
curl -sSL https://raw.githubusercontent.com/minthcm/minthcm/master/docker/docker-compose.yml -o docker-compose.yml
curl -sSL https://raw.githubusercontent.com/minthcm/minthcm/master/docker/.env -o .env
docker compose up -d
docker compose logs -f
# Open http://localhost (default admin/minthcm per docker README).
```

## Intro

MintHCM is an open-source HCM platform with AI-agent positioning (MCP/WebMCP mentioned). Includes a Docker Compose stack (app + MySQL + Elasticsearch).

**Best for:** Teams evaluating self-hosted HR platforms with extensibility and data ownership, plus potential agent integrations

**Works with:** Docker Compose for quick eval; README lists PHP 8.2, MySQL/MariaDB, and Elasticsearch for deployments

**Setup time:** 20-45 minutes

### Key facts (verified)

- GitHub: 360 stars · 74 forks · pushed 2026-05-13.
- License: AGPL-3.0 · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `docker compose up -d`.

## Main

- Use Docker Compose for evaluation only: the docker README warns the stack is intended for demo/testing, not production.

- Adjust `.env` first: the docker README explicitly calls out `.env` variables for ports, DB details, and admin credentials.

- If considering agent integrations, start with least-privilege read paths and add governance before enabling write automation on HR data.

### Source-backed notes

- Top-level README positions MintHCM as open-source (AGPL-3.0) with MCP/WebMCP/A2A mentions.
- The repo includes a `docker/` directory with `docker-compose.yml`, `.env`, and a docker README.
- docker/README includes commands for `docker compose up -d` and `docker compose logs -f`, and shows default admin credentials.

### FAQ

- **Is the Docker Compose stack production-ready?**: No. The docker README warns it's intended for demonstration and testing purposes.
- **What services are included?**: The docker README says it includes the web app plus MySQL and Elasticsearch containers.
- **Where do I find full install docs?**: The top-level README links to the installation guide on minthcm.org.

## Source & Thanks

> Source: https://github.com/minthcm/minthcm
> License: AGPL-3.0
> GitHub stars: 360 · forks: 74

---

<!-- ZH -->

## Quick Use

```bash
curl -sSL https://raw.githubusercontent.com/minthcm/minthcm/master/docker/docker-compose.yml -o docker-compose.yml
curl -sSL https://raw.githubusercontent.com/minthcm/minthcm/master/docker/.env -o .env
docker compose up -d
docker compose logs -f
# Open http://localhost (default admin/minthcm per docker README).
```

## Intro

MintHCM 是开源 HCM 平台，强调 AI-native 的 MCP/WebMCP/A2A 架构；仓库提供 Docker Compose（应用 + MySQL + Elasticsearch）便于快速体验，并可按 .env 自定义管理员账号与端口。

**Best for:** 需要数据主权与可扩展性的自建 HR 平台团队，并希望评估 agent 集成可能性

**Works with:** 快速体验走 Docker Compose；README 列出 PHP 8.2、MySQL/MariaDB 与 Elasticsearch 等依赖

**Setup time:** 20-45 minutes

### Key facts (verified)

- GitHub：360 stars · 74 forks；最近更新 2026-05-13。
- 许可证：AGPL-3.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口：`docker compose up -d`。

## Main

- Docker Compose 先用于评估：docker/README 明确提示该方案仅用于演示/测试，不建议直接用于生产。

- 先改 `.env`：docker/README 指出可通过 `.env` 自定义端口、数据库信息与管理员账号等参数。

- 若要接入 agent，建议先从只读/最小权限路径开始，并在涉及 HR 写操作前补齐治理与审计。

### Source-backed notes

- 顶层 README 将 MintHCM 定位为开源（AGPL-3.0），并提到 MCP/WebMCP/A2A 等 agent 架构概念。
- 仓库包含 `docker/` 目录：提供 `docker-compose.yml`、`.env` 与 docker/README。
- docker/README 给出 `docker compose up -d` 与 `docker compose logs -f` 等命令，并写明默认管理员账号密码。

### FAQ

- **Docker Compose 能直接上生产吗？**：不建议。docker/README 明确提示仅用于演示/测试。
- **Compose 里包含哪些服务？**：docker/README 说明包含应用本体、MySQL 数据库与 Elasticsearch。
- **完整安装文档在哪里？**：顶层 README 指向 minthcm.org 的安装指南。

## Source & Thanks

> Source: https://github.com/minthcm/minthcm
> License: AGPL-3.0
> GitHub stars: 360 · forks: 74


---
Source: https://tokrepo.com/en/workflows/minthcm-open-source-hcm-mcp-a2a-claims
Author: AI Open Source