LinkedIn职位搜索MCP服务器

一个基于TypeScript和官方MCP SDK构建的服务器,允许Claude和其他MCP客户端直接搜索LinkedIn职位,提供高级搜索和智能过滤功能。

  • by administrativetrick
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 administrativetrick/linkedin-mcp

使用说明

LinkedIn招聘MCP服务器

一种模型上下文协议(MCP)服务器,使Claude和其他MCP客户端能够直接搜索LinkedIn工作。使用TypeScript和官方MCP SDK构建。

特性

  • 🔍 高级职位搜索:使用多个筛选器搜索LinkedIn职位
  • 🎯 智能过滤:按地点、工作类型、经验级别、薪资等筛选
  • ⚡ 快速可靠:使用经过验证的 linkedin-jobs-api 包裹
  • 🔧 易于集成:适用于Claude Desktop、Claude Code和任何兼容MCP的客户端

安装

先决条件

  • Node.js 18或更高版本
  • npm或纱线

设置

  1. 克隆或下载此存储库
cd linkedin-mcp-server
  1. 安装依赖项
npm install
  1. 构建服务器
npm run build

使用Claude Desktop

配置Claude桌面

  1. 打开您的Claude Desktop配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加服务器配置:

{
  "mcpServers": {
    "linkedin-jobs": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/linkedin-mcp-server/build/index.js"
      ]
    }
  }
}

重要:替换 /ABSOLUTE/PATH/TO/ 带有项目目录的实际路径。

  1. 重新启动克劳德桌面 加载新服务器

使用npx(替代方案)

您也可以在发布到npm后使用npx运行服务器:

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

可用工具

search_linkedin_jobs

使用高级筛选选项在LinkedIn上搜索工作。

所需参数:

  • keyword (string):要搜索的职位或关键字
  • location (string):要搜索的位置(城市、州或“远程”)

可选参数:

  • dateSincePosted (枚举):“上个月”、“上周”、“24小时”
  • jobType (枚举):“全职”、“兼职”、“合同”、“临时”、“志愿者”、“实习”
  • remoteFilter (枚举):“现场”、“远程”、“混合”
  • salary (枚举):“40000”、“60000”、“80000”、“100000”、“120000”(最低工资)
  • experienceLevel (枚举):“实习”、“初级”、“助理”、“高级”、“董事”、“高管”
  • limit (string):结果数量(1-100,默认值:“10”)
  • sortBy (enum):“最近”,“相关”
  • page (string):分页页码(默认值:“0”)

查询示例

配置后,您可以向Claude询问以下问题:

"Search for software engineer jobs in San Francisco"

"Find remote product manager positions posted in the past week"

"Look for entry-level data analyst jobs in New York with a minimum salary of $80,000"

"Show me senior full-time positions for machine learning engineers in Seattle"

示例响应

Found 10 job(s) for "software engineer" in "San Francisco":

1. Senior Software Engineer
   Company: Tech Corp
   Location: San Francisco, CA
   Posted: 2 days ago
   Salary: $150,000 - $200,000
   Apply: https://linkedin.com/jobs/view/...

2. Full Stack Software Engineer
   Company: Startup Inc
   Location: San Francisco, CA (Hybrid)
   Posted: 1 week ago
   Apply: https://linkedin.com/jobs/view/...

...

发展

构建

npm run build

观看模式(用于开发)

npm run watch

使用MCP检查员进行测试

MCP检查器是测试服务器的有用工具:

npm run inspector

这将打开一个web界面,您可以在其中交互式地测试服务器的工具。

运作原理

此MCP服务器:

  1. 接收请求 通过stdio传输从Claude(或任何MCP客户端)发送
  2. 验证参数 使用Zod模式
  3. 调用LinkedIn Jobs API (通过 linkedin-jobs-api 包装)
  4. 格式化结果 转化为可读的文本响应
  5. 返回数据 回到客户

服务器通过网络抓取 linkedin-jobs-api 该软件包可以访问领英的公共职位列表。不需要身份验证或API密钥。

建筑

Claude Desktop (MCP Client)
        ↓
    stdio transport
        ↓
LinkedIn MCP Server (This project)
        ↓
linkedin-jobs-api package
        ↓
LinkedIn public job listings

故障排除

服务器未出现在Claude Desktop中

  1. 检查配置中的路径是否是绝对的(而不是相对的)
  2. 确保生成目录存在(npm run build)
  3. 完全重新启动克劳德桌面
  4. 检查Claude Desktop日志是否有错误

未返回任何结果

  1. 尝试更广泛的搜索词
  2. 删除筛选器以查看是否得到结果
  3. 检查LinkedIn是否有符合您搜索条件的工作
  4. 尝试不同的地点

构建错误

  1. 确保您已安装Node.js 18+
  2. 删除 node_modules 和 build 目录
  3. 跑 npm install 再次
  4. 跑 npm run build

技术细节

  • MCP SDK版本: 1.0.4
  • 运输:stdio(标准输入/输出)
  • 语言:TypeScript
  • 运行时:Node.js 18+
  • 数据源:LinkedIn公共职位列表(通过LinkedIn jobs api)

局限性

  • 速率限制:基础API可能有利率限制
  • 仅限公共数据:仅访问公开的职位列表
  • 无身份验证:不需要或不支持LinkedIn身份验证
  • 基于报废:使用网络抓取,这意味着如果LinkedIn更改其HTML结构,它可能会崩溃

贡献

欢迎投稿!请随时提交拉取请求。

许可证

MIT许可证-您可以在自己的项目中自由使用!

相关项目

支持

如果您遇到问题:

  1. 检查 故障排除 章节
  2. 查阅MCP文档,网址为https://modelcontextprotocol.io
  3. 在GitHub上打开一个问题,详细说明您的问题

致谢