🎯 简介

K-Track MCP 是一个基于 Model Context Protocol (MCP) 构建的灵活用工平台。允许 AI 智能体（Claude、Cursor、Dify 等）通过标准化协议直接操作真实世界的任务：

• 🔧 7 个 MCP Tools — 发布任务、搜索任务、报名、录用/拒绝、验收、进度上报
• 📂 5 个 MCP Resources — 任务列表、任务详情、仪表盘、人才库、交易记录
• 💰 内置计费系统 — API Key 认证、调用量计量、免费额度 + 余额扣费
• 🛡️ 合规结算 — 代扣个税、合规开票、资金清算
• 🎁 新用户赠送 100 次免费调用额度

🚀 快速开始

1. 申请 API Key

前往官网 → 申请接入，填写使用场景，我们将在 1 个工作日内 审核并发放 API Key。

2. 配置 Claude Desktop / Cursor

下载本仓库的 mcp-proxy.mjs，然后在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "ktrack": {
      "command": "node",
      "args": ["/path/to/mcp-proxy.mjs"],
      "env": {
        "MCP_URL": "http://8.156.66.62/mcp",
        "MCP_API_KEY": "你申请到的 API Key"
      }
    }
  }
}

3. 开始使用

配置完成后，你的 AI 助手就能调用 K-Track 的所有能力了：

你：帮我发布一个任务，找一个摄影师去春熙路拍摄实景照片，预算 200 元
AI：好的，我来通过灵工通平台发布这个任务...
(AI 调用 publish_task 工具，任务自动发布到平台)

4. Python SDK（可选）

from mcp import ClientSession

async with ClientSession("http://8.156.66.62/mcp") as session:
    result = await session.call_tool("publish_task", {
        "title": "春熙路商圈实地拍摄",
        "budget": 80,
        "location": "成都市锦江区"
    })

🔧 MCP Tools

| Tool | Description | |---|---| | publish_task | 发布用工任务到平台 | | search_tasks | 搜索任务（支持关键词、状态筛选） | | apply_task | 劳动者报名申请 | | accept_application | 录用申请人 | | reject_application | 拒绝申请人 | | approve_completion | 企业验收完成 | | submit_progress | 提交工作进度 |

📂 MCP Resources

| Resource URI | Description | |---|---| | ktrack://tasks | 所有公开任务列表 | | ktrack://tasks/{taskId} | 任务详情（含申请、进度） | | ktrack://dashboard/{enterpriseId} | 企业仪表盘统计 | | ktrack://talent | 可用人才列表 | | ktrack://transactions/{enterpriseId} | 交易订单列表 |

📦 文件说明

| 文件 | 说明 | |---|---| | mcp-proxy.mjs | stdio-to-HTTP 代理，用于 Claude Desktop / Cursor 接入 | | README.md | 本文档 |

💰 定价

| 方案 | 价格 | 说明 | |---|---|---| | 免费体验 | ¥0 | 注册即送 100 次调用 | | 按量付费 | 服务费 = 预算 × 8%（最低 ¥10/次） | 发布任务时结算 |

详情请访问 定价页面。

🔒 安全说明

• 所有 MCP 请求需携带 Authorization: Bearer <API_KEY> 头
• API Key 由平台审核后统一发放，无法自行生成
• 支持调用频率限制（每分钟 100 次）
• 支持余额管理和计费明细查看

📄 License

MIT License