Big-Data-Dienst für Rekrutierung

Dieser MCP-Dienst bietet Funktionen für Unternehmens-Keyword-Suche, Stellensuche, Arbeitgeber-Rekrutierungsprofile, Personalbedarf, Stellengehälter und Rekrutierungstrendanalysen und unterstützt Nutzer bei Arbeitsmarktforschung, Arbeitgeberanalyse und Rekrutierungsentscheidungen.

Hauptfunktionen

• 🏢 Suche nach Unternehmenskurznamen und Keywords

• 🔍 Suche nach offenen Stellen des Unternehmens

• 🏢 Analyse des Arbeitgeber-Rekrutierungsprofils

• 👥 Analyse des Personalbedarfs des Unternehmens

• 💰 Gehaltsabfrage für Stellen

• 📈 Überblick über Rekrutierungstrends des Unternehmens

Related MCP server: PayHub MCP Server

Hinweise zum Servicedesign

• Der Dienst stellt 6 Tools basierend auf tatsächlichen Geschäftsszenarien bereit, nicht flach nach Anzahl der Upstream-APIs.

• Wenn der Nutzer nur einen Unternehmenskurznamen angibt, verwenden Sie zuerst recruitment_enterprise_search, um den vollständigen Unternehmensnamen oder eine stabile ID zu erhalten.

• Die beiden Product IDs für Rekrutierungsdetails und Rekrutierungsstatistiken werden von Tools in verschiedenen Szenarien wiederverwendet.

• recruitment_demand_analysis wählt über view Details oder Statistiken aus und greift pro Aufruf nur auf eine Product ID zu.

• Die äußere Geschäftsebene von Paginierungsergebnissen enthält nur total und resultList; pageSize beträgt maximal 50.

• Lange Listen in Profilen und Statistiken werden über listLimit begrenzt, Standard 50, maximal 200.

• recruitment_trend gibt nur die Anzahl der Stellen, Statistiken der letzten drei Monate, Aktualisierungshäufigkeit und Durchschnittsgehalt zurück, um die erneute Rückgabe langer Profillisten zu vermeiden.

Umgebungsanforderungen

• Python 3.10+

• Abhängigkeiten: python-dotenv, requests, mcp

Lokaler Schnellstart

1. In das Projektverzeichnis wechseln

cd recruitment-mcp-server

2. Virtuelle Umgebung erstellen und Abhängigkeiten installieren

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. Umgebungsvariablen konfigurieren

Kopieren Sie die Vorlage für Umgebungsvariablen:

cp .env.example .env

Bearbeiten Sie die Datei .env:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT ist eine optionale Konfiguration in Sekunden; der Standardwert ist 30.

4. Streamable-HTTP-Dienst starten

python server/mcp_server.py streamable-http

Die Standardadresse des Dienstes ist http://localhost:8000/mcp.

Alternativ kann das Startskript verwendet werden:

./start_mcp_server.sh streamable-http

Es werden die drei Startmodi stdio, sse und streamable-http unterstützt.

5. MCP-Konfiguration für Cursor / Cherry Studio

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Installation und Bereitstellung der STDIO-Version

Ersetzen Sie {workdir} durch den absoluten Pfad von recruitment-mcp-server:

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID, SECRET_ID und SECRET_KEY erhalten Sie, nachdem Sie sich bei HandaaS registriert und einen Integrator aktiviert haben. Echte Anmeldedaten sollten nur in der lokalen .env-Datei oder in Bereitstellungsschlüsseln gespeichert werden.

Verfügbare Tools und Product IDs

1. recruitment_enterprise_search

Funktion: Sucht nach Kandidatenunternehmen anhand von Unternehmenskurzname, Marke, Produkt oder anderen Keywords.

Wichtige Parameter: matchKeyword erforderlich; pageIndex Standard 1; pageSize Standard 10, maximal 50.

Rückgabe: Kandidatenunternehmen total/resultList. Nach Bestätigung eines Kandidaten übergeben Sie den vollständigen Unternehmensnamen, die Unternehmens-ID oder die einheitliche Sozialkreditnummer an das Rekrutierungs-Tool.

2. recruitment_job_search

Funktion: Fragt Details zu offenen Stellen eines bestimmten Unternehmens ab.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmensname, Unternehmens-ID, Registriernummer oder einheitliche Sozialkreditnummer.

• keywordType (optional): Typ der Unternehmenskennung; unterstützt name, nameId, regNumber, socialCreditCode.

• pageIndex (optional): Seitennummer, beginnend bei 1.

• pageSize (optional): Anzahl pro Seite, Standard 50, maximal 50.

Rückgabe: total und resultList; die Stellendetails können Felder wie Stellenbezeichnung, Stadt, Ausbildung, Gehalt, Berufserfahrung, Veröffentlichungszeitpunkt und Arbeitsadresse enthalten.

3. recruitment_employer_profile

Funktion: Fragt das Rekrutierungsprofil des Unternehmens ab, einschließlich Leistungen, Rekrutierungsstädten, Stellen-Keywords und Durchschnittsgehalt.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmensname, Unternehmens-ID, Registriernummer oder einheitliche Sozialkreditnummer.

• keywordType (optional): Typ der Unternehmenskennung.

• listLimit (optional): Maximale Anzahl der zurückgegebenen Einträge in Profillistenfeldern, Standard 50, maximal 200.

Rückgabe: Rekrutierungsstatistik und -profil des Unternehmens; bei abgeschnittenen Listen wird truncatedFields zurückgegeben.

4. recruitment_demand_analysis

Funktion: Analysiert den Personalbedarf des Unternehmens; wahlweise mit Ansicht der Stellendetails oder der Unternehmensstatistik.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmenskennung.

• view (optional): details für Stellendetails; statistics für Unternehmensstatistik. Standard statistics.

• keywordType (optional): Typ der Unternehmenskennung.

• pageIndex, pageSize (optional): nur für die Ansicht details; pageSize maximal 50.

• listLimit (optional): nur für die Ansicht statistics; Standard 50, maximal 200.

Rückgabe: Die Detailansicht gibt total und resultList zurück; die Statistikansicht gibt Rekrutierungsprofil und Statistikfelder des Unternehmens zurück.

5. recruitment_salary

Funktion: Fragt die Gehaltsspanne offener Stellen des Unternehmens ab, für Gehaltsvergleiche bei Stellen und auf dem Arbeitsmarkt.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmensname, Unternehmens-ID, Registriernummer oder einheitliche Sozialkreditnummer.

• keywordType (optional): Typ der Unternehmenskennung.

• pageIndex (optional): Seitennummer, beginnend bei 1.

• pageSize (optional): Anzahl pro Seite, Standard 50, maximal 50.

Rückgabe: total und resultList; workingSalary kann Währung, Mindestgehalt und Höchstgehalt enthalten.

6. recruitment_trend

Funktion: Fragt einen Überblick über die Rekrutierungstrends des Unternehmens ab; es werden keine monatlichen Zeitreihen zurückgegeben.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmensname, Unternehmens-ID, Registriernummer oder einheitliche Sozialkreditnummer.

• keywordType (optional): Typ der Unternehmenskennung.

Rückgabe:

• recruitingCurrentCount: aktuelle Anzahl der Rekrutierungen.

• recruitingLastThreeMonthCount: Anzahl der Rekrutierungen in den letzten drei Monaten.

• recruitingLastThreeMonthNo: Anzahl der offenen Stellen in den letzten drei Monaten.

• recruitingAvgUpdate: durchschnittliche Aktualisierungshäufigkeit der Stellen.

• recruitingAvgWorkingSalary: durchschnittliches Rekrutierungsgehalt.

Anwendungsszenarien

1. Unternehmensidentifikation: Über Kurznamen oder Markenbegriffe den vollständigen Unternehmensnamen und eine stabile Kennung bestätigen.

2. Personalbedarfsforschung: Offene Stellen und Personalrichtungen des Zielunternehmens einsehen.

3. Arbeitgeberanalyse: Rekrutierungsstädte, Leistungen, Stellen-Keywords und Rekrutierungsaktivität des Unternehmens verstehen.

4. Gehaltsvergleich: Gehaltsspannen verschiedener Unternehmen oder Stellen vergleichen.

5. Bewertung von Rekrutierungstrends: Aktuellen und letzten dreimonatigen Rekrutierungsumfang sowie durchschnittliche Aktualisierungshäufigkeit analysieren.

6. Wettbewerbsinformationen: Aus Veränderungen im Rekrutierungsbedarf auf die Expansionsrichtung des Unternehmens schließen.

Hinweise zur Verwendung

1. Umgang mit Kurznamen: Wenn der Unternehmenskurzname nicht direkt abgefragt werden kann, rufen Sie zuerst recruitment_enterprise_search auf.

2. Unternehmenskennung: Nach Bestätigung eines Kandidaten wird empfohlen, die Unternehmens-ID oder die einheitliche Sozialkreditnummer zu verwenden.

3. Paginierungsbeschränkung: pageIndex beginnt bei 1, pageSize muss zwischen 1 und 50 liegen.

4. Listenbeschränkung: listLimit muss zwischen 1 und 200 liegen.

5. Ansichtsauswahl: Verwenden Sie view=details für Stellendatensätze; verwenden Sie view=statistics für ein zusammengefasstes Profil.

6. Trendabgrenzung: recruitment_trend ist ein Überblick über den aktuellen und die letzten drei Monate, keine monatliche Zeitreihe.

Beispielfragen zur Verwendung

recruitment_enterprise_search (Unternehmens-Keyword-Suche)

1. Welchem Unternehmen entspricht „Xiaomi“?

2. Suchen Sie über „JD.com“ den genauen Unternehmensnamen und die Unternehmens-ID.

recruitment_job_search (Suche nach offenen Stellen)

1. Welche Stellen schreibt 小米科技有限责任公司 derzeit aus?

2. Fragen Sie die aktuellen offenen Stellen von 北京京东世纪贸易有限公司 ab.

recruitment_employer_profile (Arbeitgeber-Rekrutierungsprofil)

1. Analysieren Sie die Rekrutierungsstädte, Leistungen und das Stellenprofil von 小米科技有限责任公司.

2. Wie hoch ist das durchschnittliche Rekrutierungsgehalt von 珠海格力电器股份有限公司?

recruitment_demand_analysis (Rekrutierungsbedarfsanalyse)

1. Fassen Sie die Personalbedarfsstruktur eines Unternehmens zusammen.

2. Listen Sie die konkreten Stellenanforderungen des Zielunternehmens auf.

recruitment_salary (Gehaltsabfrage für Stellen)

1. Zeigen Sie die Gehaltsspanne der offenen Stellen von 小米科技有限责任公司 an.

2. Wie ist das Gehaltsniveau der Stellen bei 珠海格力电器股份有限公司?

recruitment_trend (Überblick über Rekrutierungstrends)

1. Wie sind die aktuelle Rekrutierungsaktivität und der Trend der letzten drei Monate bei 小米科技有限责任公司?

2. Fragen Sie die aktuelle Anzahl der Einstellungen, offenen Stellen und das Durchschnittsgehalt von 京东 ab.

Test und Validierung

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

Die Unit-Tests verwenden Mock-HTTP-Antworten und rufen keine echten HandaaS-Rekrutierungsschnittstellen auf.