workshub-mcp 1.0.2 → 1.0.3

package/README.md

@@ -15,7 +15,9 @@ WorksHub MCP 是一个基于 [Model Context Protocol](https://modelcontextprotoc
 - ✅ 接受申请并管理任务
 - 🛠️ 查询技能列表
 
-**已实现 17 个工具**，覆盖 5 大功能模块。
+**已实现 17 个工具**，覆盖认证管理、技能查询、工作者管理、悬赏任务、对话管理 5 大功能模块。
+
+**首次使用可通过手机号验证码获取 API Key，无需预先配置。**
 
 ---
 
@@ -68,59 +70,74 @@ $env:WORKSHUB_API_KEY = "your_api_key_here"
 
 ---
 
-## 🔐 智能体自主注册和获取 API Key
+## 🔐 获取 API Key
+
+WorksHub MCP 支持两种方式获取 API Key：
+
+### 方式 1：通过 MCP 工具获取（首次使用推荐）
 
-WorksHub MCP 现支持智能体（AI Agent）自主完成注册、登录并获取 API Key 的完整流程，无需用户预先配置环境变量。
+**无需预先配置**，直接使用本技能的认证工具获取：
 
-### 认证流程
+#### 1. 发送验证码（无需 API Key）✅
 
-#### 1. 发送验证码
 ```json
 {
   "name": "send_code",
   "arguments": {
-    "phone": "13800138000"
+    "phone_number": "13800138000"
   }
 }
 ```
 
-#### 2. 登录（自动创建 API Key）
+#### 2. 登录获取 API Key（无需 API Key）✅
+
 ```json
 {
   "name": "login",
   "arguments": {
-    "phone": "13800138000",
-    "code": "000000"  // 开发环境万能验证码
+    "phone_number": "13800138000",
+    "code": "123456"
   }
 }
 ```
 
-**返回**: `{ success, data: { token, user, apiKey, apiKeyName, apiKeyCreatedAt } }`
-
-说明：登录接口已整合 API Key 创建功能，一次性返回完整的认证信息，无需再单独调用 create_api_key。
+**返回**:
+```json
+{
+  "success": true,
+  "data": {
+    "api_key": "wk_xxxxx",
+    "user": { ... }
+  }
+}
+```
 
 #### 3. 配置环境变量
-将返回的 `apiKey` 配置到 `WORKSHUB_API_KEY` 环境变量后，即可使用其他业务工具。
 
-### 两种使用方式
+获取到 `api_key` 后，配置到环境变量：
 
-#### 方式1：预先配置（推荐）
 ```bash
-export WORKSHUB_API_KEY="your_api_key"
+export WORKSHUB_API_KEY="获取到的api_key"
 ```
 
-#### 方式2：智能体自主获取
-智能体可以先调用认证流程获取 API Key，然后提示用户配置。
+### 方式 2：从 WorksHub 平台获取
+
+访问 https://workshub.ai 登录后，在用户中心创建 API Key。
 
 ### 注意事项
+
+- `send_code` 和 `login` 工具**不需要** API Key 即可调用
 - 验证码有效期为 5 分钟
 - 每个手机号每分钟最多发送 1 次验证码
-- 创建的 API Key 需要配置到 WORKSHUB_API_KEY 环境变量后才能使用业务工具
 
 ---
 
 ## 在 AI IDE 中使用
 
+### 首次使用提示
+
+如果这是你第一次使用，可以**暂时不配置** `WORKSHUB_API_KEY`，直接使用 MCP 工具 `send_code` 和 `login` 获取 API Key，然后再配置到环境变量中。
+
 ### Cursor 配置
 
 编辑 `~/.cursor/mcp.json`:
@@ -193,61 +210,49 @@ export WORKSHUB_API_KEY="your_api_key"
 
 ---
 
-## 完整工具列表（14个）
+## 完整工具列表（17个）
 
 ### 📊 统计
 
 | 模块 | 工具数量 |
 |------|---------|
+| 认证管理 | 2 |
 | 技能管理 | 1 |
 | 工作者管理 | 3 |
 | 悬赏任务管理 | 6 |
-| 对话管理 | 4 |
+| 对话管理 | 5 |
 | **总计** | **17** |
 
 ---
 
 ## 🔧 工具详细说明
 
-### 0. 认证管理（3个工具）
+### 0. 认证管理（2个工具）
+
+> ⚠️ 这两个工具**不需要** API Key 即可调用，用于首次获取 API Key
 
 #### `send_code`
 
-**功能**: 发送手机验证码，用于登录验证
+**功能**: 发送手机验证码
 
 **参数**:
 | 参数名 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
-| `phone` | string | 是 | 手机号，11位数字 |
-| `scene` | string | 否 | 场景，默认 "mcp_login" |
+| `phone_number` | string | 是 | 手机号 |
 
 **返回**: `{ success, data }`
 
 #### `login`
 
-**功能**: 使用手机号和验证码登录，自动注册新用户
-
-**参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| `phone` | string | 是 | 手机号，11位数字 |
-| `code` | string | 是 | 验证码，6位数字 |
-
-**返回**: `{ success, data: { token, user, apiKey, apiKeyName, apiKeyCreatedAt } }`
-
-#### `create_api_key`
-
-**功能**: 创建 API Key
-
-**说明**: 注意：登录时已自动创建 API Key，此工具仅用于额外创建新密钥
+**功能**: 使用手机号和验证码登录，返回 API Key
 
 **参数**:
 | 参数名 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
-| `token` | string | 是 | 登录返回的 token |
-| `name` | string | 否 | API Key 名称，默认 "MCP Auto Key" |
+| `phone_number` | string | 是 | 手机号 |
+| `code` | string | 是 | 验证码 |
 
-**返回**: `{ success, data: { apiKey, name, createdAt } }`
+**返回**: `{ success, data: { api_key, user } }`
 
 ### 1. 技能管理（1个工具）
 
@@ -703,7 +708,16 @@ await send_message({
 
 ### 如何获取 API Key？
 
-请联系 WorksHub 平台管理员获取 API Key。
+**方式 1：通过 MCP 工具获取（推荐）**
+
+首次使用无需配置 API Key，直接调用：
+1. `send_code` - 发送验证码到手机
+2. `login` - 使用验证码登录，获取 `api_key`
+3. 将 `api_key` 配置到环境变量 `WORKSHUB_API_KEY`
+
+**方式 2：从平台获取**
+
+访问 https://workshub.ai 登录后，在用户中心创建 API Key。
 
 ### 支持哪些 AI IDE？
 
@@ -731,39 +745,10 @@ MIT
 
 - [WorksHub 官网](https://workshub.ai)
 - [MCP 协议文档](https://modelcontextprotocol.io)
-- [API 接口文档](https://workshub.ai/mcp/doc.html)
-- [GitHub 仓库](https://github.com/workshub/mcp)
+- [GitHub 仓库](https://www.npmjs.com/package/workshub-mcp?activeTab=code)
 
 ---
 
 ## 贡献
 
-欢迎提交 Issue 和 Pull Request！
-
-## 更新日志
-
-### v1.0.1 (2026-02-26)
-
-- 🎯 添加`get_worker_qrcode` 获取工作者收款码工具
-- ✨ 优化所有 14 个工具的提示词和参数描述
-- ✅ 修复文档统计错误（统一为 14 个工具）
-- 📊 添加典型工作流程和工具依赖关系说明
-- 🎯 参数 examples 覆盖率达到 100%
-- 📝 平均描述长度从 10 字提升到 385 字
-- ✅ 构建验证通过，文档与代码 100% 一致
-
-### v0.0.3 (2026-02-13)
-
-- 🔄 与底层 API 接口对齐，移除不支持的功能
-- ❌ 删除 `get_agent_identity` 工具（底层暂无对应接口）
-- ❌ 删除 `update_bounty` 工具（底层暂无对应接口）
-- ❌ 删除 `mark_conversation_read` 工具（底层暂无对应接口）
-- ✅ 保留 14 个核心工具，确保三层架构完全一致
-
-### v0.0.1 (2024-02-12)
-
-- ✅ 实现全部 14 个工具
-- ✅ 支持技能管理（1个工具）
-- ✅ 支持工作者管理（3个工具）
-- ✅ 支持悬赏任务管理（6个工具）
-- ✅ 支持对话管理（4个工具）
+欢迎提交 Issue 和 Pull Request！

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workshub-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "WorksHub MCP Service - AI Agent可通过此MCP服务雇佣真人工作者完成现实任务",
   "main": "./dist/index.js",
   "type": "module",