accurlex-mcp-server 0.1.0

package/.env.example

@@ -0,0 +1,10 @@
+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.
+ACCURLEX_BILLING_PHONE=
+ACCURLEX_BEARER_TOKEN=
+
+# Optional timeout override in milliseconds (default: 600000 = 10 min).
+ACCURLEX_REQUEST_TIMEOUT_MS=600000

package/README.md

@@ -0,0 +1,332 @@
+# accurLex MCP Server
+
+accurLex 法律 AI 的 MCP 服务，支持 OpenClaw、VS Code GitHub Copilot、Claude Desktop 等 MCP 客户端。
+
+## 快速开始
+
+### 方式一：npx 直接运行（推荐）
+
+无需 clone 代码，无需手动安装依赖：
+
+```bash
+npx accurlex-mcp-server
+```
+
+### 方式二：全局安装
+
+```bash
+npm install -g accurlex-mcp-server
+```
+
+### 方式三：从源码运行
+
+```bash
+git clone https://github.com/accurlex/accurlex-mcp-server.git
+cd accurlex-mcp-server
+npm install
+cp .env.example .env
+npm start
+```
+
+## 客户端配置
+
+### OpenClaw
+
+```json
+{
+  "mcpServers": {
+    "accurlex": {
+      "command": "npx",
+      "args": ["accurlex-mcp-server"]
+    }
+  }
+}
+```
+
+### VS Code GitHub Copilot
+
+在工作区 `.vscode/settings.json` 中添加：
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "accurlex": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["accurlex-mcp-server"]
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+编辑 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）或 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）：
+
+```json
+{
+  "mcpServers": {
+    "accurlex": {
+      "command": "npx",
+      "args": ["accurlex-mcp-server"]
+    }
+  }
+}
+```
+
+## 登录认证
+
+### 方式一：使用 `accurlex_login` 工具（推荐）
+
+连接 MCP 服务后，在 AI 客户端中说：
+
+> "帮我登录 accurLex，手机号 138xxxx1234，密码 xxx"
+
+工具会返回 JWT token，按提示保存到 `.env` 文件，然后重启 AI 客户端即可。
+
+### 方式二：手动配置
+
+1. 在 https://accurlex.com 登录
+2. 打开浏览器开发者工具 → Application → localStorage → 复制 `al_jwt` 值
+3. 填入 `.env`：
+
+```env
+ACCURLEX_BILLING_PHONE=你的手机号
+ACCURLEX_BEARER_TOKEN=你的JWT令牌
+```
+
+JWT 令牌有效期 **7 天**，过期后需重新登录获取。
+
+## 可用工具
+
+| 工具 | 功能 | 计费 |
+|------|------|------|
+| `accurlex_login` | 手机号+密码登录，返回 JWT 令牌 | 免费 |
+| `accurlex_legal_qa` | 中国法律问答（deep 免费 / expert 付费） | deep=免费, expert=扣点 |
+| `accurlex_get_law_detail` | 查询法律条文 | 免费 |
+| `accurlex_contract_review` | 合同审查 → 审查意见书（仅 normal 模式） | 扣点 |
+| `accurlex_draft_document` | 法律文书生成（起诉状/答辩状/代理词等） | 扣点 |
+| `accurlex_get_account_status` | 查询账户点数余额 | 免费 |
+| `accurlex_extract_text_from_file` | 提取本地纯文本文件内容 | 免费 |
+
+## 输入限制（与网站对齐）
+
+- 法律问答问题：**10,000 字**
+- 合同审查：合同文本 + 立场合计 **10,000 字**
+- 文书生成事实描述：**10,000 字**
+- 审查人姓名：**40 字**
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `ACCURLEX_PROXY_BASE_URL` | 是 | 流式 API 地址（默认 `https://accurlex.com`） |
+| `ACCURLEX_API_BASE_URL` | 是 | PHP API 地址（默认 `https://accurlex.com/index.php`） |
+| `ACCURLEX_BILLING_PHONE` | 付费工具需要 | 计费手机号 |
+| `ACCURLEX_BEARER_TOKEN` | 账户查询需要 | 登录后获取的 JWT 令牌 |
+| `ACCURLEX_REQUEST_TIMEOUT_MS` | 否 | 请求超时毫秒数（默认 600000 = 10 分钟） |
+
+## 当前限制
+
+- 单账户模式（凭证来自 `.env`）
+- 文件提取仅支持纯文本：`.txt`、`.md`、`.json`、`.csv`、`.text`
+- 合同审查仅支持 normal 模式（审查意见书），不支持修订版
+- 不支持 DOCX、PDF、图片 OCR（请使用网站处理这些格式）
+
+## 常见问题
+
+### PowerShell 编码问题
+
+通过 PowerShell 管道手动测试时，中文字符可能被破坏。这**不影响**正常使用（VS Code、OpenClaw、Claude Desktop 均正确处理 UTF-8）。
+
+如需命令行测试，先将 JSON 写入 UTF-8 文件：
+
+```powershell
+[System.IO.File]::WriteAllText("test.jsonl", $jsonContent, [System.Text.Encoding]::UTF8)
+Get-Content test.jsonl -Encoding UTF8 | node src/index.js
+```
+
+### "tool_unavailable" 错误
+
+缺少 `.env` 配置。确保 `ACCURLEX_PROXY_BASE_URL` 和 `ACCURLEX_API_BASE_URL` 已设置。付费工具还需要 `ACCURLEX_BILLING_PHONE`。
+
+### "insufficient_balance"（HTTP 402）
+
+账户点数不足，请到 https://accurlex.com 充值。
+
+### JWT 令牌过期
+
+重新调用 `accurlex_login` 获取新令牌，更新 `.env` 后重启即可。
+
+---
+
+# accurLex MCP Server (English)
+
+Node.js MCP server that exposes accurLex legal capabilities as MCP tools.  
+Designed for use with OpenClaw, VS Code GitHub Copilot, Claude Desktop, or any MCP-compatible AI client.
+
+## Quick Start
+
+### Option A: npx (recommended)
+
+```bash
+npx accurlex-mcp-server
+```
+
+### Option B: Global install
+
+```bash
+npm install -g accurlex-mcp-server
+```
+
+### Option C: From source
+
+```bash
+git clone https://github.com/accurlex/accurlex-mcp-server.git
+cd accurlex-mcp-server
+npm install
+cp .env.example .env
+npm start
+```
+
+## Configuration
+
+### For OpenClaw
+
+```json
+{
+  "mcpServers": {
+    "accurlex": {
+      "command": "npx",
+      "args": ["accurlex-mcp-server"]
+    }
+  }
+}
+```
+
+### For VS Code GitHub Copilot
+
+Add to your workspace `.vscode/settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "accurlex": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["accurlex-mcp-server"]
+      }
+    }
+  }
+}
+```
+
+### For Claude Desktop
+
+Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "accurlex": {
+      "command": "npx",
+      "args": ["accurlex-mcp-server"]
+    }
+  }
+}
+```
+
+## Authentication
+
+Two ways to authenticate:
+
+### Option A: Use the `accurlex_login` tool (recommended)
+
+After connecting the MCP server, ask the AI client:
+
+> "帮我登录 accurLex，手机号 138xxxx1234，密码 xxx"
+
+The tool will return a JWT token and instructions to save it in `.env`. Then restart the MCP server (reload the AI client window).
+
+### Option B: Manual configuration
+
+1. Login at https://accurlex.com
+2. Open browser DevTools → Application → localStorage → copy `al_jwt` value
+3. Fill in `.env`:
+
+```env
+ACCURLEX_BILLING_PHONE=your_phone_number
+ACCURLEX_BEARER_TOKEN=your_jwt_token
+```
+
+JWT tokens are valid for **7 days**. After expiry, re-login to get a new token.
+
+## Implemented Tools
+
+| Tool | Description | Billing |
+|------|-------------|---------|
+| `accurlex_login` | Login with phone + password, returns JWT | free |
+| `accurlex_legal_qa` | Chinese-law legal Q&A (deep free / expert paid) | deep=free, expert=paid |
+| `accurlex_get_law_detail` | Retrieve law text or article details | free |
+| `accurlex_contract_review` | Contract review → 审查意见书 (normal mode only) | paid |
+| `accurlex_draft_document` | Draft legal documents (起诉状/答辩状/代理词 etc.) | paid |
+| `accurlex_get_account_status` | Query account and point balances | free |
+| `accurlex_extract_text_from_file` | Extract text from local plaintext files | free |
+
+## Input Limits (aligned with website)
+
+- Legal QA question: **10,000 chars** max
+- Contract review: contract text + standpoint combined **10,000 chars** max
+- Draft document facts: **10,000 chars** max
+- Reviewer name: **40 chars** max
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ACCURLEX_PROXY_BASE_URL` | Yes | Streaming API base URL (default: `https://accurlex.com`) |
+| `ACCURLEX_API_BASE_URL` | Yes | PHP API base URL (default: `https://accurlex.com/index.php`) |
+| `ACCURLEX_BILLING_PHONE` | For paid tools | Phone number for billing identity |
+| `ACCURLEX_BEARER_TOKEN` | For account status | JWT token from login |
+| `ACCURLEX_REQUEST_TIMEOUT_MS` | No | Request timeout in ms (default: 600000) |
+
+## Current Limitations
+
+- Single-account per server instance (credentials from `.env`)
+- Local file extraction supports plaintext only: `.txt`, `.md`, `.json`, `.csv`, `.text`
+- Contract review only supports normal mode (审查意见书), revision mode is not available
+- DOCX, PDF, image OCR are not supported (use the website for these)
+
+## Troubleshooting
+
+### PowerShell encoding issues
+
+When testing via PowerShell stdin pipe, Chinese characters may get corrupted. This only affects manual CLI testing — it does **not** affect normal MCP client usage (VS Code, OpenClaw, Claude Desktop all handle UTF-8 correctly).
+
+If you must test via CLI, write the JSON-RPC input to a UTF-8 file first:
+
+```powershell
+[System.IO.File]::WriteAllText("test.jsonl", $jsonContent, [System.Text.Encoding]::UTF8)
+Get-Content test.jsonl -Encoding UTF8 | node src/index.js
+```
+
+### "tool_unavailable" errors
+
+Missing `.env` configuration. Ensure `ACCURLEX_PROXY_BASE_URL` and `ACCURLEX_API_BASE_URL` are set. For paid tools, also set `ACCURLEX_BILLING_PHONE`.
+
+### "insufficient_balance" (HTTP 402)
+
+Your account has insufficient points. Top up at https://accurlex.com.
+
+### JWT token expired
+
+Re-run `accurlex_login` to get a new token, then update `.env` and restart.
+
+## Suggested Next Steps
+
+1. Add OAuth or SMS-based login tool for seamless credential setup
+2. Add file upload handling for DOCX, PDF, and OCR workflows
+3. Replace env-bound billing identity with per-user auth for multi-user support

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "accurlex-mcp-server",
+  "version": "0.1.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"],
+  "license": "MIT",
+  "author": "accurLex",
+  "homepage": "https://accurlex.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/accurlex/accurlex-mcp-server"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "accurlex-mcp-server": "src/index.js"
+  },
+  "files": [
+    "src/",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "dotenv": "^17.3.1"
+  }
+}

package/src/index.js

@@ -0,0 +1,756 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+
+import dotenv from 'dotenv';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+dotenv.config();
+
+const REQUEST_TIMEOUT_MS = Number(process.env.ACCURLEX_REQUEST_TIMEOUT_MS || 600000);
+const PROXY_BASE_URL = (process.env.ACCURLEX_PROXY_BASE_URL || '').trim();
+const API_BASE_URL = (process.env.ACCURLEX_API_BASE_URL || '').trim();
+const BILLING_PHONE = (process.env.ACCURLEX_BILLING_PHONE || '').trim();
+const BEARER_TOKEN = (process.env.ACCURLEX_BEARER_TOKEN || '').trim();
+
+const TEXT_FILE_EXTENSIONS = new Set(['.txt', '.text', '.md', '.json', '.csv']);
+const MAX_INPUT_CHARS = 10000;
+
+const server = new Server(
+  {
+    name: 'accurlex-mcp-server',
+    version: '0.1.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  },
+);
+
+const tools = [
+  {
+    name: 'accurlex_legal_qa',
+    description: 'Answer a Chinese-law legal question using accurLex deep or expert mode.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        question: { type: 'string', maxLength: 10000, description: 'The legal question to analyze (max 10000 chars).' },
+        mode: {
+          type: 'string',
+          enum: ['deep', 'expert'],
+          default: 'deep',
+          description: 'deep is free/basic mode. expert is paid mode.',
+        },
+        history: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              role: { type: 'string', enum: ['user', 'assistant'] },
+              content: { type: 'string' },
+            },
+            required: ['role', 'content'],
+          },
+        },
+        context_text: { type: 'string', maxLength: 10000, description: 'Optional background facts or extracted file text.' },
+      },
+      required: ['question'],
+    },
+  },
+  {
+    name: 'accurlex_get_law_detail',
+    description: 'Retrieve full law text or article details for a named Chinese law or regulation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        law_name: { type: 'string' },
+        article: { type: 'string' },
+        keyword: { type: 'string' },
+      },
+      required: ['law_name'],
+    },
+  },
+  {
+    name: 'accurlex_contract_review',
+    description: 'Review contract text and generate a written review opinion (审查意见书) from a specified standpoint.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        contract_text: {
+          type: 'string',
+          maxLength: 10000,
+          description: 'The contract text to review. Combined with standpoint must not exceed 10000 chars.',
+        },
+        file_ref: { type: 'string', description: 'Local plaintext file path as alternative to contract_text.' },
+        standpoint: {
+          type: 'string',
+          maxLength: 10000,
+          description: 'Your review standpoint and requirements, e.g. "我是甲方（买方），请重点审查付款条款和违约责任".',
+        },
+        reviewer_name: { type: 'string', maxLength: 40, description: 'Reviewer name for the opinion header, e.g. "张律师".' },
+      },
+      required: ['standpoint'],
+    },
+  },
+  {
+    name: 'accurlex_draft_document',
+    description: 'Draft a legal document based on facts and optional reference text.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        document_type: { type: 'string', description: 'Document type, e.g. "民事起诉状", "答辩状", "代理词".' },
+        facts: { type: 'string', maxLength: 10000, description: 'Key facts and claims (max 10000 chars).' },
+        case_file_refs: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Optional local plaintext file paths as reference material.',
+        },
+        style_file_ref: { type: 'string', description: 'Optional local plaintext file path as style sample.' },
+        followup_prompt: { type: 'string', maxLength: 2000, description: 'Optional additional instructions.' },
+      },
+      required: ['document_type', 'facts'],
+    },
+  },
+  {
+    name: 'accurlex_get_account_status',
+    description: 'Return the configured accurLex account status and point balances.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'accurlex_login',
+    description: 'Login to accurLex with phone number and password. Returns JWT token and account info. The token is valid for 7 days.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        phone_num: { type: 'string', description: 'Registered phone number.' },
+        password: { type: 'string', description: 'Account password.' },
+      },
+      required: ['phone_num', 'password'],
+    },
+  },
+  {
+    name: 'accurlex_extract_text_from_file',
+    description: 'Extract text from a local plaintext file path in the MVP server.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        file_ref: { type: 'string' },
+      },
+      required: ['file_ref'],
+    },
+  },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const name = request.params.name;
+  const args = request.params.arguments || {};
+
+  try {
+    switch (name) {
+      case 'accurlex_legal_qa':
+        return successResult(await handleLegalQa(args));
+      case 'accurlex_get_law_detail':
+        return successResult(await handleGetLawDetail(args));
+      case 'accurlex_contract_review':
+        return successResult(await handleContractReview(args));
+      case 'accurlex_draft_document':
+        return successResult(await handleDraftDocument(args));
+      case 'accurlex_get_account_status':
+        return successResult(await handleGetAccountStatus());
+      case 'accurlex_login':
+        return successResult(await handleLogin(args));
+      case 'accurlex_extract_text_from_file':
+        return successResult(await handleExtractTextFromFile(args));
+      default:
+        return errorResult(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    return errorResult(formatError(error), error?.code);
+  }
+});
+
+async function handleLegalQa(args) {
+  assertConfigured(PROXY_BASE_URL, 'ACCURLEX_PROXY_BASE_URL is required');
+
+  const question = asNonEmptyString(args.question, 'question');
+  if (question.length > MAX_INPUT_CHARS) {
+    throw withCode(new Error(`问题字数超出上限（${question.length}/${MAX_INPUT_CHARS}）`), 'input_too_long');
+  }
+  const mode = args.mode === 'expert' ? 'expert' : 'deep';
+  const history = Array.isArray(args.history) ? args.history : [];
+  const contextText = optionalString(args.context_text);
+  const route = mode === 'expert' ? '/ask_stream' : '/ask_free_stream';
+  const payload = {
+    prompt: contextText ? `${contextText.trim()}\n\n${question}` : question,
+    func_select: 'query_law',
+    history: buildHistoryString(history),
+    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;
+  }
+
+  const rawText = await postJsonToRoute(route, payload, headers);
+  const events = extractAccurlexEvents(rawText);
+  const answer = collectEventText(events);
+  const citations = collectCitations(events);
+  const warnings = collectWarnings(events);
+
+  return {
+    answer,
+    mode_used: mode,
+    citations,
+    warnings,
+    raw_event_count: events.length,
+  };
+}
+
+async function handleGetLawDetail(args) {
+  assertConfigured(API_BASE_URL, 'ACCURLEX_API_BASE_URL is required');
+
+  const lawName = asNonEmptyString(args.law_name, 'law_name');
+  const response = await postFormToPhp('/Main/getLawDetail', {
+    law_name: lawName,
+  });
+
+  if (!response || response.status === 'NotFound') {
+    return {
+      law_name: lawName,
+      content: '',
+      matched_articles: [],
+      status: 'NotFound',
+    };
+  }
+
+  const articles = Array.isArray(response.articles) ? response.articles : [];
+  const requestedArticle = optionalString(args.article);
+  const keyword = optionalString(args.keyword);
+  const filteredArticles = articles.filter((article) => filterArticle(article, requestedArticle, keyword));
+  const matchedArticles = filteredArticles.map(mapLawArticle);
+  const content = matchedArticles
+    .map((item) => `${item.article}\n${item.text}`.trim())
+    .join('\n\n');
+
+  return {
+    law_name: response.law?.law_name || lawName,
+    content,
+    matched_articles: matchedArticles,
+    status: response.status || 'Suc',
+  };
+}
+
+async function handleContractReview(args) {
+  assertConfigured(PROXY_BASE_URL, 'ACCURLEX_PROXY_BASE_URL is required');
+  assertConfigured(BILLING_PHONE, 'ACCURLEX_BILLING_PHONE is required for contract review');
+
+  const standpoint = asNonEmptyString(args.standpoint, 'standpoint');
+  const contractText = await resolveTextInput(args.contract_text, args.file_ref, 'contract_text');
+
+  // Enforce combined character limit (aligned with website: 10000 chars total)
+  const totalLen = contractText.length + standpoint.length;
+  if (totalLen > MAX_INPUT_CHARS) {
+    throw withCode(
+      new Error(`合同文本+审查立场总字数超出上限（${totalLen}/${MAX_INPUT_CHARS}），请精简输入`),
+      'input_too_long',
+    );
+  }
+
+  const rawText = await postJsonToRoute(
+    '/contract_review_stream',
+    {
+      user_input: contractText,
+      user_standpoint: standpoint,
+      func_select: 'contract_review',
+      output_mode: 'normal',
+      history: '',
+      stream: true,
+    },
+    {
+      'Content-Type': 'application/json',
+      'X-Billing-Phone': BILLING_PHONE,
+    },
+  );
+
+  const events = extractAccurlexEvents(rawText);
+  return {
+    review_text: collectEventText(events),
+    citations: collectCitations(events),
+    warnings: collectWarnings(events),
+    reviewer_name: optionalString(args.reviewer_name) || '',
+    raw_event_count: events.length,
+  };
+}
+
+async function handleDraftDocument(args) {
+  assertConfigured(PROXY_BASE_URL, 'ACCURLEX_PROXY_BASE_URL is required');
+  assertConfigured(BILLING_PHONE, 'ACCURLEX_BILLING_PHONE is required for drafting');
+
+  const documentType = asNonEmptyString(args.document_type, 'document_type');
+  const facts = asNonEmptyString(args.facts, 'facts');
+  if (facts.length > MAX_INPUT_CHARS) {
+    throw withCode(new Error(`事实描述字数超出上限（${facts.length}/${MAX_INPUT_CHARS}）`), 'input_too_long');
+  }
+  const referenceTexts = await resolveManyTextFiles(args.case_file_refs);
+  const styleText = optionalString(args.style_file_ref)
+    ? await readLocalTextFile(String(args.style_file_ref))
+    : '';
+  const followupPrompt = optionalString(args.followup_prompt);
+
+  const prompt = [
+    `文书类型：${documentType}`,
+    `事实与诉求：${facts}`,
+    followupPrompt ? `补充要求：${followupPrompt}` : '',
+  ].filter(Boolean).join('\n');
+
+  const rawText = await postJsonToRoute(
+    '/draft_stream',
+    {
+      prompt,
+      reference_material: referenceTexts.join('\n\n'),
+      sample_document: styleText,
+      history: '',
+      stream: true,
+    },
+    {
+      'Content-Type': 'application/json',
+      'X-Billing-Phone': BILLING_PHONE,
+    },
+  );
+
+  const events = extractAccurlexEvents(rawText);
+  return {
+    document_text: collectEventText(events),
+    document_type_used: documentType,
+    warnings: collectWarnings(events),
+    raw_event_count: events.length,
+  };
+}
+
+async function handleGetAccountStatus() {
+  assertConfigured(API_BASE_URL, 'ACCURLEX_API_BASE_URL is required');
+  assertConfigured(BEARER_TOKEN, 'ACCURLEX_BEARER_TOKEN is required for account status');
+
+  const response = await postFormToPhp(
+    '/Main/SynUserInfo',
+    { platform: 'mcp' },
+    {
+      Authorization: `Bearer ${BEARER_TOKEN}`,
+    },
+  );
+
+  const user = response?.uinfo || {};
+  return {
+    user_id: String(user.phone_num || user.phone || ''),
+    phone_masked: maskPhone(String(user.phone_num || user.phone || BILLING_PHONE || '')),
+    res_point: toInt(user.res_point),
+    vip_point: toInt(user.vip_point),
+    capabilities: {
+      deep_qa: true,
+      expert_qa: Boolean(BILLING_PHONE),
+      contract_review: Boolean(BILLING_PHONE),
+      draft_document: Boolean(BILLING_PHONE),
+    },
+    raw_profile: user,
+  };
+}
+
+async function handleLogin(args) {
+  assertConfigured(API_BASE_URL, 'ACCURLEX_API_BASE_URL is required');
+
+  const phoneNum = asNonEmptyString(args.phone_num, 'phone_num');
+  const password = asNonEmptyString(args.password, 'password');
+
+  const response = await postFormToPhp('/Main/Login', {
+    phone_num: phoneNum,
+    pwd: password,
+    platform: 'mcp',
+  });
+
+  if (!response || typeof response === 'string') {
+    const code = response === 'pwd_err' ? 'auth_failed'
+      : response === 'too_many_requests' ? 'rate_limited'
+      : response === 'account_deleted' ? 'account_deleted'
+      : 'login_failed';
+    const msg = response === 'pwd_err' ? '\u624b\u673a\u53f7\u6216\u5bc6\u7801\u9519\u8bef'
+      : response === 'too_many_requests' ? '\u767b\u5f55\u5c1d\u8bd5\u6b21\u6570\u8fc7\u591a\uff0c\u8bf7\u7a0d\u540e\u518d\u8bd5'
+      : response === 'account_deleted' ? '\u8d26\u6237\u5df2\u88ab\u5220\u9664'
+      : '\u767b\u5f55\u5931\u8d25';
+    throw withCode(new Error(msg), code);
+  }
+
+  const token = response.token || '';
+  const user = response.uinfo || {};
+
+  return {
+    success: true,
+    token,
+    phone_masked: maskPhone(phoneNum),
+    res_point: toInt(user.res_point),
+    vip_point: toInt(user.vip_point),
+    message: `\u767b\u5f55\u6210\u529f\u3002\u8bf7\u5c06\u4ee5\u4e0b\u914d\u7f6e\u586b\u5165 .env \u6587\u4ef6:\nACCURLEX_BEARER_TOKEN=${token}\nACCURLEX_BILLING_PHONE=${phoneNum}`,
+  };
+}
+
+async function handleExtractTextFromFile(args) {
+  const fileRef = asNonEmptyString(args.file_ref, 'file_ref');
+  const text = await readLocalTextFile(fileRef);
+  return {
+    text,
+    source_type: path.extname(fileRef).toLowerCase().replace('.', '') || 'text',
+    truncated: false,
+  };
+}
+
+async function postJsonToRoute(route, payload, headers = {}) {
+  const url = joinUrl(PROXY_BASE_URL, route);
+  const response = await fetchWithTimeout(url, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  });
+  return await readResponseText(response);
+}
+
+async function postFormToPhp(endpointPath, fields, headers = {}) {
+  const url = joinUrl(API_BASE_URL, endpointPath);
+  const formData = new FormData();
+
+  Object.entries(fields || {}).forEach(([key, value]) => {
+    if (value === undefined || value === null || value === '') return;
+    formData.append(key, String(value));
+  });
+
+  const response = await fetchWithTimeout(url, {
+    method: 'POST',
+    headers,
+    body: formData,
+  });
+
+  const text = await response.text();
+  if (!response.ok) {
+    throw withCode(new Error(`HTTP ${response.status}: ${text || 'request failed'}`), 'upstream_http_error');
+  }
+
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+async function fetchWithTimeout(url, options) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+
+  try {
+    const response = await fetch(url, {
+      ...options,
+      signal: controller.signal,
+    });
+    return response;
+  } catch (error) {
+    if (error?.name === 'AbortError') {
+      throw withCode(new Error(`Request timed out for ${url}`), 'upstream_timeout');
+    }
+    throw error;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+async function readResponseText(response) {
+  const text = await response.text();
+  if (!response.ok) {
+    const code = response.status === 402 ? 'insufficient_balance' : response.status === 429 ? 'rate_limited' : 'upstream_http_error';
+    throw withCode(new Error(`HTTP ${response.status}: ${text || 'request failed'}`), code);
+  }
+  return text;
+}
+
+function extractAccurlexEvents(rawText) {
+  const events = [];
+  const lines = String(rawText || '').split(/\r?\n/);
+  const fallbackParts = [];
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    if (trimmed.startsWith('data:')) {
+      const payload = trimmed.slice(5).trim();
+      if (!payload || payload === '[DONE]') continue;
+      events.push(parseLooseJson(payload));
+    } else {
+      fallbackParts.push(line);
+    }
+  }
+
+  const fallbackText = fallbackParts.join('\n').trim();
+  if (fallbackText) {
+    const parsedObjects = parseConcatenatedJsonObjects(fallbackText);
+    if (parsedObjects.length > 0) {
+      events.push(...parsedObjects);
+    } else {
+      events.push(parseLooseJson(fallbackText));
+    }
+  }
+
+  return events;
+}
+
+function parseLooseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { data: text };
+  }
+}
+
+function parseConcatenatedJsonObjects(text) {
+  const objects = [];
+  let bracketCount = 0;
+  let start = -1;
+  let inString = false;
+  let escaped = false;
+
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text[i];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (ch === '\\') {
+      escaped = true;
+      continue;
+    }
+    if (ch === '"') {
+      inString = !inString;
+      continue;
+    }
+    if (inString) continue;
+
+    if (ch === '{') {
+      if (bracketCount === 0) start = i;
+      bracketCount += 1;
+    } else if (ch === '}') {
+      bracketCount -= 1;
+      if (bracketCount === 0 && start >= 0) {
+        const jsonText = text.slice(start, i + 1);
+        try {
+          objects.push(JSON.parse(jsonText));
+        } catch {
+          return [];
+        }
+        start = -1;
+      }
+    }
+  }
+
+  return objects;
+}
+
+function collectEventText(events) {
+  return events
+    .map((event) => {
+      if (event?.data === undefined || event?.data === null) return '';
+      return String(event.data);
+    })
+    .join('')
+    .trim();
+}
+
+function collectWarnings(events) {
+  const warnings = [];
+  for (const event of events) {
+    if (event?.error) warnings.push(String(event.error));
+    if (event?.msg && String(event.msg).toLowerCase() !== 'suc') warnings.push(String(event.msg));
+  }
+  return Array.from(new Set(warnings));
+}
+
+function collectCitations(events) {
+  const citations = [];
+
+  for (const event of events) {
+    if (Array.isArray(event?.citations)) {
+      for (const citation of event.citations) {
+        citations.push(normalizeCitation(citation));
+      }
+      continue;
+    }
+
+    if (event?.law_name || event?.article) {
+      citations.push(normalizeCitation(event));
+    }
+  }
+
+  return citations.filter((item) => item.law_name || item.article || item.snippet);
+}
+
+function normalizeCitation(value) {
+  return {
+    law_name: optionalString(value?.law_name) || '',
+    article: optionalString(value?.article) || optionalString(value?.article_num) || '',
+    snippet: optionalString(value?.snippet) || optionalString(value?.original_content) || '',
+  };
+}
+
+function buildHistoryString(history) {
+  return history
+    .map((item) => `${item.role === 'assistant' ? 'Assistant' : 'User'}: ${String(item.content || '')}`)
+    .join('\n');
+}
+
+function filterArticle(article, requestedArticle, keyword) {
+  const articleLabel = String(article?.article_num || article?.article_no || article?.title || '').trim();
+  const text = String(article?.content || article?.article_content || article?.text || '').trim();
+
+  if (requestedArticle && !articleLabel.includes(requestedArticle)) {
+    return false;
+  }
+  if (keyword && !(`${articleLabel}\n${text}`).includes(keyword)) {
+    return false;
+  }
+  return true;
+}
+
+function mapLawArticle(article) {
+  return {
+    article: String(article?.article_num || article?.article_no || article?.title || ''),
+    text: String(article?.content || article?.article_content || article?.text || ''),
+  };
+}
+
+async function resolveTextInput(textValue, fileRef, fieldName) {
+  const text = optionalString(textValue);
+  if (text) return text;
+  if (optionalString(fileRef)) return readLocalTextFile(String(fileRef));
+  throw withCode(new Error(`${fieldName} or file_ref is required`), 'invalid_input');
+}
+
+async function resolveManyTextFiles(fileRefs) {
+  if (!Array.isArray(fileRefs) || fileRefs.length === 0) return [];
+  const texts = [];
+  for (const fileRef of fileRefs) {
+    if (!fileRef) continue;
+    texts.push(await readLocalTextFile(String(fileRef)));
+  }
+  return texts;
+}
+
+async function readLocalTextFile(fileRef) {
+  const resolvedPath = path.resolve(String(fileRef));
+  const ext = path.extname(resolvedPath).toLowerCase();
+  if (!TEXT_FILE_EXTENSIONS.has(ext)) {
+    throw withCode(
+      new Error(`Unsupported file type for MVP extraction: ${ext || '(no extension)'}`),
+      'unsupported_file_type',
+    );
+  }
+
+  try {
+    return await fs.readFile(resolvedPath, 'utf8');
+  } catch (error) {
+    throw withCode(new Error(`Failed to read file: ${resolvedPath} (${error.message})`), 'file_read_error');
+  }
+}
+
+function joinUrl(base, pathname) {
+  const normalizedBase = String(base || '').replace(/\/+$/, '');
+  const normalizedPath = String(pathname || '').replace(/^\/+/, '');
+  return `${normalizedBase}/${normalizedPath}`;
+}
+
+function asNonEmptyString(value, fieldName) {
+  const text = sanitizeText(optionalString(value));
+  if (!text) {
+    throw withCode(new Error(`${fieldName} is required`), 'invalid_input');
+  }
+  return text;
+}
+
+function optionalString(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function sanitizeText(text) {
+  return text
+    .replace(/\u0000/g, '')
+    .replace(/[\u0001-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '');
+}
+
+function assertConfigured(value, message) {
+  if (!value) {
+    throw withCode(new Error(message), 'tool_unavailable');
+  }
+}
+
+function toInt(value) {
+  const parsed = Number.parseInt(String(value ?? ''), 10);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
+
+function maskPhone(phone) {
+  if (!phone || phone.length < 7) return phone;
+  return `${phone.slice(0, 3)}****${phone.slice(-4)}`;
+}
+
+function withCode(error, code) {
+  error.code = code;
+  return error;
+}
+
+function formatError(error) {
+  if (!error) return 'Unknown error';
+  if (typeof error === 'string') return error;
+  return error.message || String(error);
+}
+
+function successResult(result) {
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+    structuredContent: result,
+  };
+}
+
+function errorResult(message, code = 'tool_error') {
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify({ code, message }, null, 2),
+      },
+    ],
+    isError: true,
+  };
+}
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('accurLex MCP server running on stdio');
+}
+
+main().catch((error) => {
+  console.error('Failed to start accurLex MCP server:', error);
+  process.exit(1);
+});