Web3 Jobs MCP

🚀 Web3 Jobs MCP 服務器

這是一個 MCP 服務器，它能讓 AI 代理實時訪問來自 web3.career 的精心篩選的 Web3 職位信息，實現智能職位發現和職業洞察。

🚀 快速開始

本服務器能讓 AI 代理實時獲取 Web3 工作崗位信息，實現智能的崗位發現與職業洞察。以下將詳細介紹它的特性、安裝和使用方法。

✨ 主要特性

• 職位查詢工具：可按以下條件篩選 Web3 職位：
  • 遠程工作狀態（remote=True 表示僅顯示遠程工作職位）
  • 國家（例如 "美國"，不區分大小寫）
  • 職位標籤（例如 "react"、"區塊鏈"，不區分大小寫）
  • 數量限制（1 - 100 個職位，默認 50 個）
• Markdown 輸出：以格式化的 Markdown 列表形式返回職位列表，包含：
  • 職位 ID、標題、公司、地點、遠程工作狀態
  • 發佈時間（從 date_epoch 轉換為 YYYY-MM-DD 格式）
  • 申請鏈接（指向 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 桌面端：

將服務器作為 Claude 桌面應用程序安裝：

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 桌面端）中調用 query_jobs 工具：

• 示例 1：獲取 5 個遠程區塊鏈職位：

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

• 示例 2：獲取美國的 10 個職位：

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

示例輸出：

# Web3 職位列表

- **職位 ID**：103945
  - **標題**：應用密碼經濟學與機制設計
  - **公司**：Subzero Labs
  - **地點**：遠程
  - **遠程工作**：是
  - **發佈時間**：2025-06-01
  - **申請鏈接**：[申請](https://web3.career/r/1QTOzATM__UVWHaa)
  - **描述**：關於 Rialo 我們是去中心化金融（DeFi）領域的先驅力量...

- **職位 ID**：103944
  - **標題**：區塊鏈工程師
  - **公司**：CryptoTech
  - **地點**：遠程
  - **遠程工作**：是
  - **發佈時間**：2025-05-31
  - **描述**：加入我們的團隊，為全球客戶構建前沿的區塊鏈解決方案...
  - **申請鏈接**：[申請](https://web3.career/r/2XYZabc123)

*來源：web3.career*

使用 search_jobs_prompt

為特定職位角色和工作地點生成搜索提示：

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

這將返回如下提示：

查找遠程地區區塊鏈開發人員的 Web3 職位。提供來自 web3.career 的職位標題、公司、地點和申請鏈接。

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE 文件。