104.com.tw MCP Server

MCP server for Taiwan's largest job platform — search jobs, browse companies, and apply, all from Claude.

Disclaimer: This project is not affiliated with or endorsed by 104 Human Resources Group (104人力銀行). Use in accordance with 104.com.tw's Terms of Service.

Tools

| Tool | Auth required | Description | |---|---|---| | search_jobs | No | Search job listings by keyword, location, salary, remote, etc. | | get_job_detail | No | Full job posting: description, salary, requirements, welfare | | search_companies | No | Search companies by name | | get_company_detail | No | Company profile + optional current job listings | | login | — | Log in with email/password | | logout | — | Log out | | apply_job | Yes | Apply to a job with optional cover letter | | save_job | Yes | Bookmark a job | | save_company | Yes | Follow a company |

npm package name

This repository publishes mcp-104jobs (see package.json). That is the package to install and the binary name for MCP clients.

If you see 104-mcp-server on npm as well, it is the same project published under an older alternate name. Prefer mcp-104jobs; the duplicate can be marked deprecated on npm by its owner (npm deprecate 104-mcp-server@"*" "Use mcp-104jobs instead").

Setup

Via npx (recommended)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "104": {
      "command": "npx",
      "args": ["-y", "mcp-104jobs"]
    }
  }
}

Manual

npm install
npm run build

Add to Claude Desktop config:

{
  "mcpServers": {
    "104": {
      "command": "node",
      "args": ["/path/to/104-mcp/dist/index.js"]
    }
  }
}

Usage examples

• "Search for backend engineer jobs in Taipei with remote work"
• "Show me the details for job 8tft1"
• "Search for companies named Google in Taiwan"
• "Get the company profile for 1a2x6bmutz including their job openings"
• "Login with my 104 account and apply to job 8kq2g"

Location codes

| Code | Area | |---|---| | 6001001000 | 台北市 | | 6001002000 | 新北市 | | 6001003000 | 桃園市 | | 6001005000 | 台中市 | | 6001006000 | 台南市 | | 6001008000 | 高雄市 |

Compatible clients

Works with any MCP-compatible AI client:

| Client | Config file | |---|---| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | Cline (VS Code) | MCP Servers panel in sidebar | | Continue.dev | ~/.continue/config.json → mcpServers | | Zed | settings.json → context_servers |

All clients use the same config block:

{
  "mcpServers": {
    "104": {
      "command": "npx",
      "args": ["-y", "mcp-104jobs"]
    }
  }
}

ChatGPT / GPT Actions

A REST API is deployed at https://104-mcp.vercel.app for use as a GPT Action.

OpenAPI spec: https://104-mcp.vercel.app/openapi.json

To add to a Custom GPT:

1. Go to chat.openai.com/gpts → Create
2. Click Configure → Add actions
3. Paste the OpenAPI spec URL above
4. Save and test

Available via GPT Actions (read-only, no auth required):

• searchJobs — search job listings
• getJobDetail — full job posting
• searchCompanies — search companies
• getCompanyDetail — company profile

Notes

• No API key needed for read-only tools
• Auth uses 104's OIDC flow (Ory Hydra with PKCE)
• Apply/save require a valid 104.com.tw account