Web3 Jobs MCP

🚀 Web3 Jobs MCP Server

このMCPサーバーは、AIエージェントがweb3.careerから選りすぐったWeb3の求人をリアルタイムに取得できるようにし、インテリジェントな求人検索とキャリア洞察を提供します。

🚀 クイックスタート

このWeb3 Jobs MCP Serverを使用することで、AIエージェントがWeb3の求人をリアルタイムに取得できるようになります。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 求人クエリツール：以下の条件でWeb3の求人を絞り込めます。
  • リモート勤務の有無 (remote=True でリモート勤務のみの求人)
  • 国名 (例: "United States"、大文字小文字を区別しません)
  • 求人タグ (例: "react", "blockchain"、大文字小文字を区別しません)
  • 表示件数 (1 - 100件、デフォルトは50件)
• Markdown形式での出力：求人一覧を整形されたMarkdownリストとして返します。内容は以下の通りです。
  • 求人ID、タイトル、会社名、勤務地、リモート勤務の有無
  • 公開日 (date_epoch から YYYY-MM-DD 形式に整形)
  • 応募URL (web3.careerへのクリック可能なリンク)
  • 説明 (プレーンテキスト、100文字にトリミング)
• 検索プロンプト：役割と任意の勤務地に基づいて、使いやすい求人検索クエリを生成します。

📦 インストール

前提条件

• Python 3.10以上
• web3.careerのAPIトークン ( web3.career/web3-jobs-api で申請)
• 依存関係の管理に uv を使用することを推奨

インストール手順

1. リポジトリのクローン：

   git clone https://github.com/kukapay/web3-jobs-mcp.git
   cd web3-jobs-mcp
   

2. 依存関係のインストール： uv を使用する場合：

   uv sync
   

   または、pip を使用する場合：

   pip install mcp[cli] python-dotenv
   

3. Claude Desktopへのインストール：

   サーバーをClaude Desktopアプリケーションとしてインストールします：

   uv run mcp install cli.py --name "Web3 Jobs"
   

   参考としての設定ファイル：

   {
      "mcpServers": {
          "Web3 Jobs": {
              "command": "uv",
              "args": [ "--directory", "/path/to/web3-jobs-mcp", "run", "main.py" ],
              "env": { "WEB3_CAREER_API_TOKEN": "your-api-token" }  
          }
      }
   }
   

   /path/to/web3-jobs-mcp を実際のインストールパスに、your-api-token をweb3.careerのAPIトークンに置き換えてください。

💻 使用例

サーバーの起動

開発モードでMCPインスペクター付きでサーバーを起動します：

uv run mcp dev main.py

これにより、ツールとプロンプトをテストするためのWebインターフェースが開きます。

または、直接起動することもできます：

uv run main.py

query_jobs ツールの使用

MCPインスペクターまたは互換性のあるクライアント (例: Claude Desktop) で query_jobs ツールを呼び出します。

• 例1：リモートのブロックチェーン関連の求人を5件取得する：

  query_jobs(remote=True, tag="blockchain", limit=5)
  

• 例2：アメリカの求人を10件取得する：

  query_jobs(country="United States", limit=10)
  

サンプル出力：

# Web3 Job Listings

- **Job ID**: 103945
  - **Title**: Applied Crypto-Economics & Mechanism Design
  - **Company**: Subzero Labs
  - **Location**: Remote Remote Remote
  - **Remote**: Yes
  - **Published At**: 2025-06-01
  - **Apply URL**: [Apply](https://web3.career/r/1QTOzATM__UVWHaa)
  - **Description**: About Rialo We are a pioneering force in the decentralized finance (DeFi) space...

- **Job ID**: 103944
  - **Title**: Blockchain Engineer
  - **Company**: CryptoTech
  - **Location**: Remote
  - **Remote**: Yes
  - **Published At**: 2025-05-31
  - **Description**: Join our team to build cutting-edge blockchain solutions for global clients...
  - **Apply URL**: [Apply](https://web3.career/r/2XYZabc123)

*Source: web3.career*

search_jobs_prompt の使用

特定の役割と勤務地に対する検索プロンプトを生成します：

/search_jobs_prompt role="blockchain developer" location="remote"

これにより、以下のようなプロンプトが返されます：

Find Web3 jobs for a blockchain developer role in remote. Provide job titles, companies, locations, and application links from web3.career.

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。