HiPo Work

HiPo Work MCP Server

---

🌟 プラットフォームの理念

従来の採用活動では、優れた履歴書が静的なドキュメントや閉鎖的な履歴書データベースに埋もれ、キーワードとのマッチングを受け身で待つことがよくあります。

HiPo Work は、この状況を変えることを目指しています：

• 履歴書を高精度な意味資産として蓄積：AI エージェントまたはプラットフォームによる解析を通じて、求職者の専門スキル、個人プロジェクト、ビジネスへの実装、業務成果をすべて構造化し、意味ベクトルに変換します。
• AI ツールからいつでも履歴書を検索可能に：Claude Code、Cursor、OpenAI CodeX、Hermes Agent、各企業が独自に構築した採用エージェントなど、あらゆるツールから MCP ツールを使って数秒で候補者を正確に検索、評価し、つなげられます。
• 機会と人材が自然に出会えるように：大量応募や手当たり次第の選考は不要です。エージェントがインテリジェントなアシスタントとして機能し、実際の能力とプロジェクトの深さに基づいて、採用側と求職者が相互に的確なアプローチを行えるようにします。

---

🔗 関連エコシステムと公開リポジトリ

HiPo Work は、MCP プロトコルサービスやクライアント向けコマンドラインツールなどを網羅する、エージェントネイティブな採用エコシステムを提供しています：

プロジェクト / プラットフォーム	リンク	説明
公式サイト	hipowork.com	求職者センター、採用担当者コンソール、求人掲載、意味マッチングのデモを提供
hipo-mcp（本プロジェクト）	github.com/sexylin/hipo-mcp	Model Context Protocol 標準に準拠し、OAuth 2.0 に対応したリモート MCP サーバー
hipowork-cli	github.com/sexylin/hipowork-cli	クライアント向けコマンドラインツールセット（PyPI: pip install hipowork-cli）。hipo / hipowork-cli のターミナルコマンドを提供
MCP Registry	io.github.sexylin/hipo-work	MCP 公式 Registry の認証済みサービス識別子

---

🚀 クイックスタート（主要エージェント対応）

リモート MCP 接続エンドポイントは共通です：https://mcp.hipowork.com/mcp

1. クライアントの設定

Claude Code CLI

claude mcp add hipo https://mcp.hipowork.com/mcp

Claude Desktop

claude_desktop_config.json に設定します：

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

Cursor / VS Code

MCP 設定パネルで（SSE / HTTP 方式）追加します：

https://mcp.hipowork.com/mcp

OpenAI CodeX

~/.codex/config.toml に設定します：

[mcp_servers.hipo]
url = "https://mcp.hipowork.com/mcp"

Hermes Agent

~/.hermes/config.yaml に設定します：

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

WorkBuddy

コンソールで【拡張機能と設定】→【MCP サーバー】を開き、カスタム HTTP リモートサービスを追加します：

URL: https://mcp.hipowork.com/mcp

---

2. 二段階の起動と認証の仕組み

HiPo Work は、安全な **OAuth 2.0 認可コードフロー（PKCE S256）**を採用しており、長期間使用するハードコードされたキーを手動で管理する必要はありません：

1. サービスの設定：上記の手順に従って各クライアントを設定します。
2. 認証の開始と利用：
   • エージェントのダイアログで指示（例：「自分に合う求人を探してください」や「ブロックチェーン開発エンジニアを検索してください」）を出すと、エージェントが初めてツールを呼び出した際に 401 の通知を受け取ります；
   • クライアントのターミナルまたは画面に認可 URL が表示され、ブラウザーが自動的に開きます（https://mcp.hipowork.com/authorize）；
   • メールアドレスを入力して認証します（公式サイト hipowork.com にログイン済みの場合は、**「認可を確認」**をクリックするだけですぐに許可できます）；
   • 認可が完了すると、トークンが自動的に安全な方法で永続化され、エージェントは途切れることなくタスクを続行します。

---

🛠️ MCP ツール一覧

求職者（Candidate）ツール

ツール名	説明
import_resume	コア：求職者の履歴書をインポートまたは更新します。エージェントがローカルで解析した構造化データを渡します。基本情報、職務経歴、個人プロジェクトの経験（projects）、学歴、スキルセットなどを含み、履歴書ファイルを Base64 形式で同時に保存できます
upload_resume_attachment	現在の求職者の元の履歴書添付ファイル（PDF、DOCX、画像などの Base64 エンコード）を個別にアップロードまたは追加提出します
match_jobs_for_me	現在の履歴書に基づいて募集中のすべての求人をインテリジェントにマッチングし、マッチ度の降順で並べた求人一覧と評価の内訳（業界、スキル年数、経験）を返します

採用担当者（Employer）ツール

ツール名	説明
create_company	企業情報を作成します（会社名と会社概要を入力し、既定の企業にするか指定できます）
set_default_company	指定した企業を既定の会社に設定します
list_companies	現在の採用担当者が管理するすべての企業一覧と既定の企業を取得します
publish_job	採用要件を掲載します。スキル要件、経験年数、勤務地、給与（salary_currency: CNY/USDT/USD/EUR/GBP/AUD/SGD に対応）などの構造化条件を設定できます
close_job	掲載済みの採用要件を終了し、候補者とのマッチングと応募を停止します
match_candidates	カスタム条件（required/preferred）に基づいて、プラットフォーム全体で公開されている候補者をマッチングし、多面的な評価を出力します
match_job_requirement	掲載済みの job_id を渡すと、多面的な意味マッチングと必須条件のマッチングを自動的に実行します
search_candidates	自然言語（例：「成都、経験5年、SolidityとGoに精通したフルスタック」）を使って人材データベースを直接検索します
market_analysis	特定の技術スタック、業界、都市における人材の需給動向、平均経験年数の分布、市場の分析情報を取得します
get_stats	プラットフォームの募集中の求人総数、人材データベースのアクティブな人材の分布など、全体的な統計情報を取得します

オープン / 認証ツール

ツール名	説明
send_verification_code	指定したメールアドレスにログイン／登録用の認証コードを送信します
register_or_login	認証コードを送信して登録またはログインを完了します

---

💡 エージェントとの典型的な会話例（すぐに使えるプロンプト）

求職者の例：エージェントにローカルの履歴書を解析してプラットフォームへインポートしてもらう

“ローカルの履歴書 /path/to/my_resume.pdf を読み取り、職務経歴、個人プロジェクトの経験、スキル、学歴を抽出して、HiPo Work の import_resume ツールを呼び出してプラットフォームにインポートし、元の添付ファイルもアップロードしてください。インポートに成功したら、最もマッチする求人を検索してください。”

採用担当者の例：求人を掲載して、条件に合う人材を自動で探す

“成都で Senior Python バックエンド開発職の求人を掲載してください。経験3年以上で、FastAPI と PostgreSQL に精通していることが条件です。月給は 20k-35k（通貨は CNY/USDT/USD/EUR/GBP/AUD/SGD に対応）です。掲載後すぐに自動マッチングを実行し、最も適した候補者を上位3名まで挙げて、マッチする理由を分析してください。”

---

📄 ライセンス

本プロジェクトは MIT License に基づくオープンソースです。