mcpField
W
workway

workway

リモート
docs.workway.devビジネス・マーケティング16 週間前に更新
リポジトリ公式サイト

workway について

workwayはWorkWayのバックエンドAPIで、企業・求人の検索、絞り込み、Greenhouse、Ashby、YCからの求人取り込みを担います。ページ分割された求人一覧では、絞り込みメタデータとファセットも返します。

主な機能

  1. 01企業・求人検索API
  2. 02検索・絞り込み可能な求人一覧
  3. 03絞り込みファセット数
  4. 04Greenhouse、Ashby、YCからの取り込み
  5. 05サイトマップとフィードのルート

活用シーン

  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 Backend

WorkWay を支える API サービスです。企業・求人の検索、フィルター、サイトマップ、Greenhouse／Ashby／YC からのデータ取り込みを提供します。

Stack

  • Node.js（ES モジュール）＋ Express 5
  • PostgreSQL（pg）

Structure

  • src/server.js — アプリケーションの起動、DB の初期化、ルートの登録、グレースフルシャットダウン
  • src/config.js — 環境変数／設定のマッピング
  • src/routes/ — API ルートハンドラー
  • src/services/ — ビジネスロジック
  • src/dao/ — SQL クエリと DAO 抽象化
  • src/utils/ — ロガー、定数、解析／分類ヘルパー
  • src/data/greenhouseCompanies.js — Greenhouse の名前空間のシードリスト
  • docs/DETAILED_DOCS.md — アーキテクチャとエンドポイントの詳細リファレンス

Setup

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 — フィルター UI 用のファセット件数を返します。

リクエスト／レスポンスの完全なリファレンス：docs/DETAILED_DOCS.md

Health

  • GET /health — 稼働時間とタイムスタンプ
  • GET / — サーバーの稼働確認

Ingestion

Cron 形式の HTTP エンドポイントで Greenhouse、Ashby、YC の企業を読み込み、それらの求人を取得し、分類（ドメイン／レベル／雇用形態）して PostgreSQL にアップサートします。

Production

workway.dev を提供しています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。