Web3 Jobs MCP Server

Web3 Jobs MCP 服务

一个 MCP 服务，为 AI Agent 提供对 web3.career 精选 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 Inspector 在开发模式下启动服务：

uv run mcp dev main.py

这会打开一个用于测试工具和提示词的 Web 界面。

或者直接运行：

uv run main.py

使用 query_jobs 工具

在 MCP Inspector 或兼容的客户端（例如 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 文件。