mcpField
W
workway

workway

远程服务
docs.workway.dev商业与营销16 周前更新

关于 workway

workway 是 WorkWay 的后端 API,负责公司与职位发现、筛选,以及从 Greenhouse、Ashby 和 YC 导入职位。分页职位接口还会返回筛选元数据和分类计数。

主要功能

  1. 01公司与职位发现 API
  2. 02可搜索和筛选的职位列表
  3. 03筛选分类计数
  4. 04导入 Greenhouse、Ashby 和 YC 数据
  5. 05站点地图与 feed 路由

适用场景

  1. 01为职位发现界面提供数据
  2. 02筛选并分页浏览职位
  3. 03从公司招聘平台加载职位

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://www.workway.dev/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://www.workway.dev/api/mcp需要授权

工具

详细介绍

WorkWay 后端

为 WorkWay 提供支持的 API 服务,涵盖公司和职位发现、筛选器、站点地图,以及 Greenhouse/Ashby/YC 数据导入。

技术栈

  • Node.js(ES modules)+ Express 5
  • PostgreSQL(pg)

目录结构

  • src/server.js — 应用引导、数据库初始化、路由挂载、优雅关闭
  • src/config.js — 环境与配置映射
  • src/routes/ — API 路由处理程序
  • src/services/ — 业务逻辑
  • src/dao/ — SQL 查询和 DAO 抽象
  • src/utils/ — 日志记录器、常量、解析和分类辅助函数
  • src/data/greenhouseCompanies.js — Greenhouse 命名空间种子列表
  • docs/DETAILED_DOCS.md — 详细的架构和端点参考

设置

npm install

在仓库根目录创建 .env:

APP_ENV=dev
POSTGRES_DB_HOST=localhost
POSTGRES_DB_PORT=5432
POSTGRES_DB_USER=postgres
POSTGRES_DB_PASSWORD=root
POSTGRES_DB_DATABASE=eqhqdb
POSTGRES_DB_MAX_CONNECTIONS=20
PORT=3000

运行:

npm run dev   # or: npm start

默认地址为 http://localhost:3000。

API

基础路径:/api

  • /api/company、/api/job、/api/feed、/api/filter、/api/cron
  • /api/sitemap.xml、/api/sitemaps/*
  • GET /api/job/list — 支持分页、搜索和筛选的职位列表,返回 jobs、meta、applied_filters、facets
  • GET /api/job/filters — 筛选界面的分面计数

完整的请求/响应参考:docs/DETAILED_DOCS.md

健康检查

  • GET /health — 运行时长 + 时间戳
  • GET / — 服务运行状态检查

数据导入

类 Cron 的 HTTP 端点会加载 Greenhouse、Ashby 和 YC 公司,获取其职位,对职位进行分类(领域/级别/雇佣类型),并写入 PostgreSQL;若记录已存在则更新。

生产环境

为 workway.dev 提供服务。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。