AI导哈

Boss直聘MCP服务

一款用于Boss直聘招聘平台的MCP服务，提供二维码自动登录、职位搜索和自动向招聘者打招呼的能力，适用于通过MCP客户端自动化完成招聘求职流程。

  • by derekdong-star
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 derekdong-star/mcp-boss

使用说明

BossZhipin MCP Server

A Model Context Protocol (MCP) server for Boss直聘 recruitment platform.

Core Features:

  • 🔐 Auto Login - QR code scan with automatic security verification
  • 💼 Job Search - Search by keyword, city, experience, salary
  • 👋 Auto Greeting - Send greetings to recruiters automatically

Quick Start

1. Install

pip install -r requirements.txt
playwright install chromium

2. Run

python mcp_boss.py

Server starts at http://127.0.0.1:8000

3. MCP Client Config

Add to your MCP client (e.g., Cursor):

{
  "mcpServers": {
    "mcp-boss": {
      "command": "python",
      "args": ["/path/to/mcp_boss.py"]
    }
  }
}

Usage Examples

Login

User: Login to BossZhipin
LLM:  [Calls login_full_auto]
      QR: http://127.0.0.1:8000/static/qrcode_xxx.png
      Please scan with BossZhipin APP

User: [Scans and confirms]
LLM:  Login successful!

Search Jobs

search_jobs(
    keyword="Python",
    city="上海",
    experience="三到五年",
    salary="20-50k"
)

Send Greeting

send_greeting(
    security_id="xxx",
    job_id="yyy"
)

Available Tools

Tool Description
login_full_auto() Auto login with QR code
login_start_interactive() Interactive login with guidance
get_login_info() Get login status & cookies
get_recommend_jobs() Get recommended jobs
search_jobs() Search jobs by keyword
send_greeting() Send greeting to HR

Parameters:

  • experience: 在校生, 应届生, 不限, 一年以内, 一到三年, 三到五年, 五到十年, 十年以上
  • job_type: 全职, 兼职
  • salary: 3k以下, 3-5k, 5-10k, 10-20k, 20-50k, 50以上
  • city: 北京, 上海, 深圳, 广州, 杭州, 成都, 武汉, 西安, 南京, 苏州

Resources

URI Description
boss://status Server status
boss://config Job search config (experience, salary maps)
boss://login/info Login status & cookies

HTTP Endpoints

  • http://127.0.0.1:8000/mcp - MCP endpoint
  • http://127.0.0.1:8000/static/{file} - Static files (QR codes)
  • http://127.0.0.1:8000/login/start - Web login page

How It Works

  1. QR Login - Generates QR code, monitors scan status in background thread
  2. Security Check - Uses Playwright headless browser to auto-complete verification
  3. Cookie Management - Automatically obtains __zp_stoken__ and valid cookies
  4. Smart Params - Accepts Chinese parameters, converts to API codes automatically

Project Structure

mcp-boss/
├── mcp_boss.py          # Main server
├── requirements.txt     # Dependencies
├── static/              # QR code images
└── README.md

Dependencies

  • Python 3.12+
  • fastmcp >= 0.4.0
  • requests >= 2.31.0
  • playwright >= 1.40.0
  • pycryptodome >= 3.19.0
  • starlette >= 0.27.0

Docker

docker build -t mcp-boss .
docker run -p 8000:8000 mcp-boss

Debug Mode

Set headless=False in complete_security_check() to see browser:

browser = await p.chromium.launch(headless=False)

License

MIT License

相关 MCP