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 文件。