MCP-iQuesta

iQuesta MCP 服务

适用于 iQuesta.com 的 Model Context Protocol 连接器。iQuesta.com 是法国的实习和学徒岗位搜索平台。

让任何兼容 MCP 的 AI Agent（Claude、ChatGPT、Gemini...）都能直接在对话中搜索职位。

端点

https://mcp.iquesta.com/api/mcp

协议：MCP 2024-11-05 · 传输方式：Streamable HTTP · 技术栈：Laravel 10 / PHP 8.1

可用工具

工具	描述
search_jobs	按关键词（标题）、招聘信息描述、地区、学科、专业、合同类型搜索职位
get_job	根据职位 ID 获取完整的职位详情
list_filters	列出筛选器的可选值（地区、学科、专业、合同类型）

注意：工具 get_similar_jobs 暂时已停用——对应的 API 端点尚未在 iQuesta 端实现。开发完成后将重新启用。

search_jobs 的参数

参数	类型	描述
term	string	在招聘信息标题中搜索的关键词
description	string	在招聘信息的完整文本中搜索的关键词（工作内容、所需技能等...）
disciplines	integer	学科 ID，通过 list_filters(filter='disciplines') 获取。例如：3 = “商业 / 分销 / 销售”
matieres	integer[]	专业 ID 列表（比 disciplines 更细化），通过 list_filters(filter='matieres') 获取。例如：27 = “计算机 - 开发”
regions	integer	法国地区 ID，通过 list_filters(filter='regions') 获取
contracts	string	合同类型 ID：1（实习）、2（学徒制）、-4（工作）、-5（学生兼职）
begin	integer	期望的开始月份（1-12）
duration	integer	工作的最长时长（月）
limit	integer	最大结果数（默认：10，建议上限：20）

term、description、matieres、disciplines 或 regions 中至少需要提供一个参数。

disciplines（60 个值）和 matieres（68 个值）：每个专业都属于某个学科；大多数专业与学科一一对应，只有少数学科（化学、房地产）细分为多个专业。优先使用 disciplines，需要更精细的筛选时使用 matieres。

使用示例

初始化

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

工具列表

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

按标题和地区搜索职位

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "term": "développeur",
        "regions": 10,
        "contracts": "1"
      }
    }
  }'

按专业和描述搜索

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "description": "Python",
        "matieres": [27]
      }
    }
  }'

列出可用筛选器

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": { "name": "list_filters", "arguments": { "filter": "all" } }
  }'

客户端配置

Claude.ai / Claude Desktop

在连接器设置中添加：

{
  "mcpServers": {
    "iquesta": {
      "url": "https://mcp.iquesta.com/api/mcp"
    }
  }
}

关于 iQuesta

iQuesta.com 收录了法国数千个实习和学徒岗位，面向学生和应届毕业生。

许可证

MIT