How theyahia/hh-mcp works
This is an MCP server exposing hh.ru recruiting data to AI-agent clients. The main workflow is a tool request over stdio or Streamable HTTP, dispatch through registered handlers, query the hh.ru API, and return either compact summaries or raw JSON. Its tool families cover vacancies, resumes, employers, reference data and suggestions, salary estimates, and token validation. The sampled source shows the client and several handler-to-client/formatter calls; unsampled handler details are represented from the README, so their internal call paths are not inferred.
Main entry points: index.ts MCP server · client.ts API client · format.ts Response formatting · vacancies.ts Vacancy tools
Components 10
MCP entry
- MCP server
src/index.ts
Recruiting tools
- Vacancy tools
src/tools/vacancies.ts - Resume tools
src/tools/resumes.ts - Employer tools
src/tools/employers.ts - Reference tools
src/tools/references.ts - Salary estimates
src/tools/salary.ts
Shared services
- API client
src/client.ts - Response formatting
src/format.ts
External systems
- hh.ru API
Other components
- AI agent
Connections 18
- AI agent → MCP server: requests tools
README.md - MCP server → AI agent: returns results
README.md - MCP server → Vacancy tools: dispatches
src/index.ts - MCP server → Resume tools: dispatches
src/index.ts - MCP server → Employer tools: dispatches
src/index.ts - MCP server → Reference tools: dispatches
src/index.ts - MCP server → Salary estimates: dispatches
src/index.ts - Vacancy tools → API client: requests data
src/tools/vacancies.ts - Vacancy tools → Response formatting: formats results
src/tools/vacancies.ts - Resume tools → API client: requests data
src/tools/resumes.ts - Resume tools → Response formatting: formats results
src/tools/resumes.ts - Employer tools → API client: requests data
src/tools/employers.ts - Employer tools → Response formatting: formats results
src/tools/employers.ts - Reference tools → API client: requests data
src/tools/references.ts - Reference tools → Response formatting: flattens areas
src/tools/references.ts - Salary estimates → API client: samples vacancies
src/tools/salary.ts - Salary estimates → Response formatting: formats salary
src/tools/salary.ts - API client → hh.ru API: fetches API
src/client.ts