Remote Jobs Mcp Server

Jobicy リモート求人 MCP

AI アシスタントを Jobicy に接続して、公開されているリモート求人を検索したり、個別の求人情報を読んだり、企業や職種を探したり、Jobicy のフィルター名を解決したりできます。本番環境の MCP サービスは https://jobicy.com/mcp でホストされています。このリポジトリには、ローカルプロセスを実行するクライアントやホスティングプラットフォーム向けの、スタンドアロンの Node.js MCP サーバーも含まれています。公開されている Jobicy API エンドポイントのみを使用しており、サイトのバックエンドは含まれていません。

MCP クライアントを接続する

ストリーマブル 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 でローカルプロセスを起動してください。Glama のリポジトリビルドでは、このソースから MCP プロセスが実行されるため、コンテナーのコマンドとして mcp-remote やホストされている /mcp URL を設定しないでください。Jobicy のライブエンドポイントは引き続き独立して利用できます。

求人を探す

ほとんどの検索には search_jobs を使用してください。求人の簡潔な情報が返され、求人の詳細な説明は含まれません。たとえば、アシスタントに次のように依頼してください。

英国在住の候補者が応募できるリモートのバックエンドエンジニアリング職を、最大10件探してください。職種名、企業名、公開されている場合は給与、Jobicy のリンクを表示してください。

同等のツール呼び出しは次のとおりです。

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

レスポンスには jobs、jobCount、nextCursor、hasMore、appliedFilters が含まれます。jobCount が数えるのはそのレスポンス内の求人のみで、条件に一致するすべての求人ではありません。次のページを取得するには、同じフィルターを指定し、nextCursor を cursor として渡してください。カーソルは不透明な値として扱ってください。フィルターを変更すると無効になります。

1件の求人の完全な説明を取得するには、数値の id を指定して get_job を呼び出してください。geo フィルターは、候補者の応募資格を表します。国で検索した場合、その国のより広い地域が対象の求人や、場所を問わず候補者を受け入れる求人も含まれることがあります。給与とロゴのフィールドは、公開データがある場合にのみ含まれます。

利用可能なツール

ツール	使用する場面	入力
search_jobs	カーソルページネーションを使用して、公開求人の概要を検索します。	query、geo、industry、jobType、jobLevel、company、postedAfter、salaryMin、salaryMax、currency、limit、cursor（いずれも任意）。
get_job	公開求人の詳細を1件取得します。	必須の id。
get_similar_jobs	関連する求人の短いリストを検索します。	必須の jobId。limit は任意。
search_companies	特定の公開企業、または関連性の高い少数の企業を検索します。企業ディレクトリではなく、検索機能です。	query、industry、geo のうち少なくとも1つ。limit は任意（最大10）。
get_company	公開企業のプロフィールを1件取得します。	必須の id（数値IDまたはスラッグ）。
get_company_jobs	1社に関連付けられた公開求人を検索します。	必須の companyId。limit、cursor は任意。
get_role	Jobicy の職種ガイドを取得します。	必須の職種 role スラッグ。
get_related_roles	ある職種に関連する職種を探します。	必須の role。limit は任意。
resolve_taxonomy	地域名または業界名を Jobicy のフィルタースラッグに変換します。	必須の type（location または industry）と query。
list_taxonomies	利用可能な公開フィルタースラッグとラベルを確認します。	必須の 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。	従来の全求人フィードと content.text 内の JSON を維持します。
get_taxonomies	type：locations または industries。	従来の content.text 内の JSON を維持します。

新しいツールは structuredContent と、content 内の読み取り可能な JSON の両方を提供します。すべてのツールは読み取り専用です。レスポンスには、求人や企業の全体件数、および Jobicy の内部統計は含まれません。

リソース

MCP リソースに対応したクライアントは、jobicy://jobs/{id}、jobicy://companies/{id}、jobicy://roles/{slug} を使用して、個々の公開エンティティを取得できます。公開参照リストは jobicy://taxonomies/locations と jobicy://taxonomies/industries から利用できます。リソースはツールを補完するものであり、全求人または全企業のフィードを公開するものではありません。

ヘルプとセキュリティ

接続またはドキュメントに問題がある場合は、GitHub issue を作成してください。セキュリティ上の懸念は、SECURITY.md に記載されている方法で非公開に報告してください。

ライセンス

このドキュメントは MIT License の下で利用できます。