roundhr-mcp-server/README.md

MCP server for RoundHR database tools

# RoundHR MCP Server

MCP server for RoundHR database tools - 채용 관련 데이터 스키마 조회 및 쿼리 실행 도구

## 🚀 Quick Install for Claude Desktop

### Option 1: Quick Install via Smithery (Recommended)

For Claude Desktop:

```bash
npx -y @smithery/cli@latest install @GoodGoodCo/roundhr-mcp-server --client claude
```

For Cursor:

```bash
npx -y @smithery/cli@latest install @GoodGoodCo/roundhr-mcp-server --client cursor
```

For Windsurf:

```bash
npx -y @smithery/cli@latest install @GoodGoodCo/roundhr-mcp-server --client windsurf
```

For Cline:

```bash
npx -y @smithery/cli@latest install @GoodGoodCo/roundhr-mcp-server --client cline
```

The installer will prompt you for:

- API_KEY

### Option 2: Manual Installation

#### Run with NPX

```bash
npx roundhr-mcp-server
```

## Claude Desktop Configuration

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "roundhr-mcp-server": {
      "command": "npx",
      "args": ["roundhr-mcp-server"],
      "env": {
        "API_KEY": "your_api_key"
      }
    }
  }
}
```

## 📋 Available Tools

| Tool | Description |
|------|-------------|
| `get_database_schema` | 채용 관련 데이터베이스 스키마 조회 |
| `execute_query` | SQL 쿼리 실행 및 결과 반환 |

## 📝 Usage Example

After installation, you can ask Claude:
- "데이터베이스 스키마를 조회해 주세요"
- "지원자 수를 조회하는 쿼리를 실행해 주세요"
- "최근 일주일간 지원자 현황을 분석해 주세요"

## 📄 License

MIT