accurlex-mcp-server 0.2.1 → 0.3.0

package/.env.example

@@ -1,8 +1,8 @@
 ACCURLEX_PROXY_BASE_URL=https://accurlex.com
 ACCURLEX_API_BASE_URL=https://accurlex.com/index.php
 
-# Fill in after running accurlex_login tool, or manually from the website.
-# JWT token is valid for 7 days.
+# Required for all query tools (legal QA, contract review, drafting).
+# Register at https://accurlex.com to get your phone-number account.
 ACCURLEX_BILLING_PHONE=
 ACCURLEX_BEARER_TOKEN=
 

package/README.md

@@ -30,7 +30,8 @@ accurLex MCP Server 是一个面向中国法律工作流的 MCP 服务，支持
         "args": ["-y", "accurlex-mcp-server"],
         "env": {
           "ACCURLEX_PROXY_BASE_URL": "https://accurlex.com",
-          "ACCURLEX_API_BASE_URL": "https://accurlex.com/index.php"
+          "ACCURLEX_API_BASE_URL": "https://accurlex.com/index.php",
+          "ACCURLEX_BILLING_PHONE": "你的注册手机号"
         }
       }
     }
@@ -48,6 +49,12 @@ accurLex MCP Server 是一个面向中国法律工作流的 MCP 服务，支持
       "args": ["-y", "accurlex-mcp-server"],
       "env": {
         "ACCURLEX_PROXY_BASE_URL": "https://accurlex.com",
+        "ACCURLEX_API_BASE_URL": "https://accurlex.com/index.php",
+        "ACCURLEX_BILLING_PHONE": "你的注册手机号"
+      }
+    }
+  }
+}
         "ACCURLEX_API_BASE_URL": "https://accurlex.com/index.php"
       }
     }
@@ -71,30 +78,32 @@ accurLex MCP Server 是一个面向中国法律工作流的 MCP 服务，支持
 
 ### 3. 验证安装
 
-在 AI 对话中发送以下消息测试（免费，无需登录）：
+在 AI 对话中发送以下消息测试（免费配额，需已配置 `ACCURLEX_BILLING_PHONE`）：
 
 > "劳动合同试用期最长不能超过多久？"
 
 如果 AI 调用了 `accurlex_legal_qa` 工具并返回了法律分析，说明安装成功。
 
-### 4. 配置登录信息（使用更多能力前）
+### 4. 配置登录信息（账户查询、付费功能）
+
+使用前，请先到 https://accurlex.com 注册账号，将手机号填入客户端配置的 `ACCURLEX_BILLING_PHONE` 字段。
 
-如果你需要账户查询，或希望通过登录流程获取当前账号的配置值，可以在 AI 对话中说：
+如果需要账户查询，可在 AI 对话中说：
 
 > "帮我登录 accurLex，手机号 138xxxx1234，密码 xxx"
 
-登录成功后，将返回的 `ACCURLEX_BEARER_TOKEN` 和 `ACCURLEX_BILLING_PHONE` 添加到客户端配置的 `env` 字段中，然后重启客户端。
+登录成功后，将返回的 `ACCURLEX_BEARER_TOKEN` 添加到客户端配置的 `env` 字段中，然后重启客户端。
 
 说明：
 
-- `accurlex_get_account_status` 需要 `ACCURLEX_BEARER_TOKEN`
-- expert 问答、合同审查、法律文书生成按当前实现需要 `ACCURLEX_BILLING_PHONE`
+- `ACCURLEX_BILLING_PHONE` 是注册手机号，所有工具（login/extract 除外）均需要
+- `ACCURLEX_BEARER_TOKEN` 是 JWT 令牌，`accurlex_get_account_status` 需要
 
 ## 可用功能
 
 | 功能 | 工具名 | 计费 | 预期耗时 |
 |------|--------|------|---------|
-| 法律问答（免费） | `accurlex_legal_qa` (deep) | 免费 | 10-30 秒 |
+| 法律问答（免费配额，需注册） | `accurlex_legal_qa` (deep) | 免费 | 10-30 秒 |
 | 法律问答（专业） | `accurlex_legal_qa` (expert) | 扣点 | 10-30 秒 |
 | 合同审查 | `accurlex_contract_review` | 扣点 | 1-3 分钟 |
 | 法律文书生成 | `accurlex_draft_document` | 扣点 | 1-2 分钟 |
@@ -110,7 +119,7 @@ accurLex MCP Server 是一个面向中国法律工作流的 MCP 服务，支持
 | 问题 | 解决方案 |
 |------|---------|
 | 工具未出现在 AI 对话中 | 确认配置文件路径正确（VS Code 必须在工作区**根目录**的 `.vscode/settings.json`），然后重启客户端 |
-| `tool_unavailable` 错误 | 环境变量未设置，检查 `env` 字段中的 `ACCURLEX_PROXY_BASE_URL` 和 `ACCURLEX_API_BASE_URL` |
+| `tool_unavailable` 错误 | 环境变量未设置，检查 `env` 字段中的 `ACCURLEX_PROXY_BASE_URL`、`ACCURLEX_API_BASE_URL`、`ACCURLEX_BILLING_PHONE` |
 | `ENOENT` / `npx` 找不到 | Node.js 未安装或未在 PATH 中，Windows 上尝试将 `command` 改为 `npx.cmd` |
 | 合同审查“超时” | 合同审查正常需要 1-3 分钟，请耐心等待 |
 | JWT 令牌过期 | 重新调用 `accurlex_login`，更新配置中的 `ACCURLEX_BEARER_TOKEN`，重启客户端 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "accurlex-mcp-server",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "MCP server for accurLex Chinese legal AI — legal Q&A, contract review, law lookup, document drafting",
   "keywords": ["mcp", "legal", "chinese-law", "contract-review", "accurlex", "ai"],
@@ -9,7 +9,7 @@
   "homepage": "https://accurlex.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/accurlex/accurlex-mcp-server.git"
+    "url": "git+https://github.com/MrPunchLeoanrdo/accurlex-mcp-server.git"
   },
   "engines": {
     "node": ">=18"

package/src/index.js

@@ -46,7 +46,7 @@ const tools = [
           type: 'string',
           enum: ['deep', 'expert'],
           default: 'deep',
-          description: 'deep is free/basic mode. expert is paid mode.',
+          description: 'deep = free query quota, requires registered account (ACCURLEX_BILLING_PHONE). expert = paid mode, costs points.',
         },
         history: {
           type: 'array',
@@ -185,11 +185,8 @@ async function handleLegalQa(args) {
     stream: true,
   };
 
-  const headers = { 'Content-Type': 'application/json' };
-  if (mode === 'expert') {
-    assertConfigured(BILLING_PHONE, 'ACCURLEX_BILLING_PHONE is required for expert mode');
-    headers['X-Billing-Phone'] = BILLING_PHONE;
-  }
+  assertConfigured(BILLING_PHONE, 'ACCURLEX_BILLING_PHONE is required. Register at https://accurlex.com to get your account.');
+  const headers = { 'Content-Type': 'application/json', 'X-Billing-Phone': BILLING_PHONE };
 
   const rawText = await postJsonToRoute(route, payload, headers);
   const events = extractAccurlexEvents(rawText);
@@ -312,7 +309,7 @@ async function handleGetAccountStatus() {
     res_point: toInt(user.res_point),
     vip_point: toInt(user.vip_point),
     capabilities: {
-      deep_qa: true,
+      deep_qa: Boolean(BILLING_PHONE),
       expert_qa: Boolean(BILLING_PHONE),
       contract_review: Boolean(BILLING_PHONE),
       draft_document: Boolean(BILLING_PHONE),