hipo-mcp

# HiPo Work MCP Server

[![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
[![OAuth 2.0](https://img.shields.io/badge/Auth-OAuth2.0-green)](https://oauth.net/2/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

将 HiPo Work 招聘平台工具暴露为 MCP (Model Context Protocol) 工具，供 AI Agent 调用。支持 OAuth 2.0 自动授权。

**适用客户端：** Claude Desktop、Hermes Agent、Cursor、VS Code、Cline 等所有支持 MCP 的客户端

---

## 功能一览

HiPo Work 是一个面向 AI Agent 的招聘平台：

- **求职者**：通过 Agent 导入结构化简历（`import_resume`），可保留工作经历、项目经历、教育经历、技能、证书和语言能力
- **招聘方**：通过 Agent 发布岗位（`publish_job`）、智能匹配候选人（`match_candidates`）、市场分析（`market_analysis`）
- **自动认证**：OAuth 2.0 授权码流程，用户在授权页完成登录后即可使用

---

## 快速开始

### 1. 配置 MCP 客户端

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "hipo": {
      "url": "https://mcp.hipowork.com/mcp"
    }
  }
}
```

**Hermes Agent** (`~/.hermes/config.yaml`):

```yaml
mcp_servers:
  hipo:
    url: "https://mcp.hipowork.com/mcp"
```

**VS Code / Cursor** MCP 配置面板，添加：

```
https://mcp.hipowork.com/mcp
```

### 2. 首次授权

1. 首次调用工具时，自动打开浏览器 `https://mcp.hipowork.com/authorize`
2. 输入邮箱 → 获取验证码 → 输入验证码
3. 授权完成，自动返回客户端，**后续无需再操作**

> **已登录用户免重复验证**：若你已在 Web 端（hipowork.com）登录，登录态会自动同步到授权域。之后从 Agent 发起授权时，授权页直接显示「确认授权」按钮，无需再次输入邮箱和验证码

---

## 工具列表

| 工具名 | 说明 | 认证 |
|--------|------|------|
| `send_verification_code` | 发送邮箱验证码（注册/登录前调用） | 公开 |
| `register_or_login` | 邮箱验证码注册/登录 | 公开 |
| `publish_job` | 发布招聘岗位（结构化条件） | employer |
| `match_candidates` | 匹配候选人（含评分明细+工作经历） | employer |
| `match_job_requirement` | 按岗位 ID 自动匹配候选人 | employer |
| `search_candidates` | 自然语言搜索候选人 | employer |
| `get_stats` | 平台统计数据 | employer |
| `market_analysis` | 技能/行业人才供需分析 | employer |
| `import_resume` | 导入简历（Agent 解析后传入结构化数据，包含工作/项目/教育经历） | candidate |

---

## 认证机制

### OAuth 2.0（唯一推荐方式）
首次登录时的流程：

```text
配置 MCP 地址 `https://mcp.hipowork.com/mcp`
→ 客户端打开 HiPo Work 授权页
→ 输入邮箱和验证码
→ 确认角色及客户端权限
→ 自动返回 MCP 客户端
→ 后续自动使用 OAuth Token
```
---

---

## License

MIT