Remote Jobs Mcp Server

Jobicy 远程职位 MCP

将 AI 助手连接到 Jobicy，以查找公开的远程职位、阅读单个职位信息、发现公司和职业角色，并解析 Jobicy 筛选器名称。生产环境中的 MCP 服务托管于 https://jobicy.com/mcp。此代码库还包含一个独立的 Node.js MCP 服务，适用于运行本地进程的客户端和托管平台。它仅使用 Jobicy 的公开 API 端点，不包含该网站的后端。

连接 MCP 客户端

Streamable HTTP URL： https://jobicy.com/mcp

在支持远程服务 URL 的 MCP 客户端中，添加一个名为 jobicy 的服务，并粘贴该 URL。如果客户端询问传输方式，请选择 Streamable HTTP。使用这些公开的只读工具无需 Jobicy 账号或访问令牌。

使用 JSON MCP 配置的客户端可以采用以下示例：

{
  "mcpServers": {
    "jobicy": {
      "url": "https://jobicy.com/mcp"
    }
  }
}

仅支持 SSE 的旧版客户端可以使用传输类型 sse 连接到 https://jobicy.com/mcp/sse。客户端会处理关联的 /messages 路由。MCP 发现文档也可供使用。

连接后，请让助手列出可用的 MCP 工具。你应该会看到 search_jobs、get_job 及下方的其他工具。

运行代码库服务

需要 Node.js 20 或更高版本。使用 pnpm install --frozen-lockfile 安装依赖项，然后运行 node server.js。该进程通过标准输入和输出传输 MCP；它旨在由 MCP 客户端或托管平台启动。无需 Jobicy 凭据。所有职位、公司、角色和分类数据均来自 Jobicy 的公开 API。

支持本地 MCP 命令的客户端可以使用：

{
  "mcpServers": {
    "jobicy": {
      "command": "node",
      "args": ["/absolute/path/to/remote-jobs-mcp-server/server.js"]
    }
  }
}

对于 Glama 的 Dockerfile 配置，使用 pnpm install --frozen-lockfile 构建代码库，并使用 mcp-proxy -- node server.js 启动本地进程。请勿将 mcp-remote 或托管的 /mcp URL 配置为容器命令：Glama 的代码库构建会从此源码运行 MCP 进程。Jobicy 在线端点仍可独立使用。

查找职位

大多数搜索请使用 search_jobs。它会返回精简的职位信息，不包含完整职位描述。例如，可以这样询问助手：

查找最多 10 个面向英国候选人的远程后端工程职位。显示职位名称、公司、可用时显示薪资，以及 Jobicy 链接。

等效的工具调用如下：

{
  "name": "search_jobs",
  "arguments": {
    "query": "backend engineer",
    "geo": "uk",
    "limit": 10
  }
}

响应包含 jobs、jobCount、nextCursor、hasMore 和 appliedFilters。jobCount 仅统计该响应中的职位，而非所有匹配职位。若要请求下一页，请在筛选条件不变的情况下，将 nextCursor 作为 cursor 传入。请将游标视为不透明值；更改筛选条件会使其失效。

若要获取某个职位的完整描述，请使用其数字 id 调用 get_job。geo 筛选条件表示候选人的资格范围：按国家/地区搜索时，也可能包含面向该国/地区所属更大区域，或面向任何地区候选人的职位。仅当公开数据中包含薪资和徽标信息时，才会返回相应字段。

可用工具

工具	适用场景	输入
search_jobs	使用游标分页搜索精简的公开职位结果。	可选 query、geo、industry、jobType、jobLevel、company、postedAfter、salaryMin、salaryMax、currency、limit、cursor。
get_job	查看一条完整的公开职位信息。	必填 id。
get_similar_jobs	查找一小组相关职位。	必填 jobId；可选 limit。
search_companies	查找特定的公开公司或一小组相关公司。这是搜索工具，不是公司目录。	至少填写 query、industry 或 geo 中的一项；可选 limit（最多为 10）。
get_company	查看一份公开公司档案。	必填 id（数字 ID 或 slug）。
get_company_jobs	查找与某家公司关联的公开职位。	必填 companyId；可选 limit、cursor。
get_role	查看 Jobicy 职业角色指南。	必填 role slug。
get_related_roles	探索与某个职业角色相关的角色。	必填 role；可选 limit。
resolve_taxonomy	将地点或行业名称转换为 Jobicy 筛选器 slug。	必填 type（location 或 industry）和 query。
list_taxonomies	浏览可用的公开筛选器 slug 和标签。	必填 type：locations、industries、job_types 或 job_levels。

如果筛选条件很明显，请直接调用 search_jobs。不确定时，请使用 resolve_taxonomy：例如，United States 会解析为 usa，而 Developer 可能解析为 engineering。如果匹配结果不确定，该工具会返回候选项，而不是自行猜测。新工具中的地点标签不显示表情符号。

旧版工具

现有 MCP 客户端可以继续使用：

工具	输入	兼容性
get_jobs	count、geo、industry、tag；别名：location、category、search、keyword。	保留原始的完整职位 feed，并将 JSON 放在 content.text 中。
get_taxonomies	type：locations 或 industries。	保留原始 JSON，并将其放在 content.text 中。

新工具会同时提供 structuredContent 和 content 中的可读 JSON。所有工具均为只读。响应不会提供职位或公司的全局总数，也不会提供 Jobicy 内部统计数据。

资源

支持 MCP 资源的客户端可以通过 jobicy://jobs/{id}、jobicy://companies/{id} 和 jobicy://roles/{slug} 读取单个公开实体。公开参考列表位于 jobicy://taxonomies/locations 和 jobicy://taxonomies/industries。资源是对工具的补充；它们不会提供所有职位或所有公司的 feed。

帮助与安全

如遇连接或文档问题，请提交 GitHub issue。请按照 SECURITY.md 中的说明私下报告安全问题。

许可证

本文档采用 MIT License 授权。