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

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

Compatible clients

Works with any MCP-compatible AI client:

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 discovery flow (Ory Hydra with PKCE). Tokens and cookies

are held only in memory for the lifetime of the local MCP process; expiring

access tokens are refreshed when 104 issues a refresh token.

• Apply/save require a valid 104.com.tw account