wjx-mcp-server 0.1.2

package/.env.example

@@ -0,0 +1,11 @@
+# 问卷星 OpenAPI API Key
+WJX_API_KEY=sk-wjx-xxx
+
+# 企业通讯录 ID（通讯录相关操作需要）
+# WJX_CORP_ID=orgXXXXXXXXXX
+
+# HTTP 传输模式（可选，默认 stdio）
+# MCP_TRANSPORT=http
+# PORT=3000
+# MCP_AUTH_TOKEN=your_bearer_token
+# MCP_SESSION=stateful

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wjx-mcp-server contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,317 @@
+# WJX MCP Server
+
+> 问卷星 MCP Server — 通过 [Model Context Protocol](https://modelcontextprotocol.io/) 将[问卷星](https://www.wjx.cn) OpenAPI 完整暴露给 AI 客户端。
+
+[![npm version](https://img.shields.io/npm/v/wjx-mcp-server)](https://www.npmjs.com/package/wjx-mcp-server)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D20-green)](https://nodejs.org/)
+
+通过 Claude、Cursor 或任何 MCP 兼容的 AI 客户端，以自然语言创建、管理和分析问卷。服务器封装了问卷星 OpenAPI，提供 **56 个 Tools**、**8 个 Resources** 和 **12 个 Prompts**。
+
+---
+
+## 功能特性
+
+### 7 大模块 · 56 个 Tools
+
+| 模块 | 工具数 | 说明 |
+|------|:------:|------|
+| **Survey** 问卷管理 | 12 | 创建、查询、列表、状态变更、设置读写、删除、题目标签、回收站、文本创建、预览 |
+| **Response** 答卷数据 | 10 | 查询、实时查询、下载、统计报告、代填提交、文件链接、中奖者、改分、360° 报告、清空 |
+| **Contacts** 通讯录 | 14 | 成员管理、管理员管理、部门管理、标签管理 |
+| **SSO** 免登录 | 4 | 生成子账号 / 用户系统 / 合作伙伴 / 问卷创建编辑的 SSO 链接 |
+| **User System** 用户体系 | 5 | 参与者增删改、绑定查询、分配查询 |
+| **Multi-User** 多用户管理 | 5 | 子账号增删改恢复、子账号列表 |
+| **Analytics** 本地分析 | 6 | 解码答卷、NPS 计算、CSAT 计算、异常检测、指标对比、推送解密 |
+
+### 8 个 MCP Resources
+
+AI 客户端可直接读取的参考数据：`survey-types`、`question-types`、`survey-statuses`、`analysis-methods`、`response-format`、`user-roles`、`push-format`、`dsl-syntax`。
+
+### 12 个 MCP Prompts
+
+预置工作流模板：`design-survey`、`analyze-results`、`create-nps-survey`、`configure-webhook`、`nps-analysis`、`csat-analysis`、`cross-tabulation`、`sentiment-analysis`、`survey-health-check`、`comparative-analysis`、`create-survey-by-text`、`batch-export`。
+
+### 生产级特性
+
+- **请求签名** — SHA1 签名 + 30 秒时间窗口，每次请求自动计算
+- **TraceID** — 每请求生成 32 位 GUID，便于调试与追踪
+- **自动重试** — 读操作遇 5xx/429 自动重试（指数退避，最多 2 次）；写操作不重试
+- **超时控制** — 默认 15 秒，可按请求配置
+- **双传输模式** — stdio（默认）+ Streamable HTTP（Bearer token 认证）
+- **零额外依赖** — 运行时仅需 `@modelcontextprotocol/sdk` 和 `zod`
+
+---
+
+## 模块总览
+
+```mermaid
+flowchart LR
+    Client[AI 客户端] --> Entry[index.ts]
+    Entry --> |stdio| STDIO[StdioTransport]
+    Entry --> |--http| HTTP[StreamableHTTP]
+
+    STDIO --> Server[McpServer]
+    HTTP --> Server
+
+    Server --> R[Resources ×8]
+    Server --> P[Prompts ×12]
+    Server --> Tools[Tools ×56]
+
+    Tools --> S1[survey ×12]
+    Tools --> S2[response ×10]
+    Tools --> S3[contacts ×14]
+    Tools --> S4[sso ×4]
+    Tools --> S5[user-system ×5]
+    Tools --> S6[multi-user ×5]
+    Tools --> S7[analytics ×6]
+
+    S1 & S2 & S3 & S5 & S6 --> API[api-client.ts]
+    API --> Sign[SHA1 签名]
+    API --> WJX[(问卷星 OpenAPI)]
+
+    S4 --> URL[本地 URL 构建]
+    S7 --> Calc[本地计算 / 解密]
+```
+
+---
+
+## 快速开始
+
+> 目标：5 分钟内完成首次运行。
+
+### 前置条件
+
+- **Node.js >= 20**
+- **问卷星 OpenAPI 凭据**（`appid` + `appkey`）
+
+#### 获取 API 凭据
+
+1. 登录[问卷星控制台](https://www.wjx.cn)
+2. 进入 **账号设置 → API自动登录** 或联系客户经理开通 OpenAPI 权限
+3. 获取 `appid`（数字 ID）和 `appkey`（签名密钥，与 SSO 密钥相同）
+
+### 安装与构建
+
+```bash
+git clone <your-repo-url>
+cd wjx-ai-kit/wjx-mcp-server
+npm install
+npm run build
+```
+
+### 配置
+
+```bash
+cp .env.example .env
+```
+
+编辑 `.env`，填入你的凭据：
+
+```dotenv
+WJX_APP_ID=your_appid
+WJX_APP_KEY=your_appkey
+```
+
+### 启动（stdio 模式）
+
+```bash
+npm start
+```
+
+### 启动（HTTP 模式）
+
+适用于远程部署或服务化场景：
+
+```bash
+# 通过 npm script
+npm run start:http
+
+# 或通过环境变量
+MCP_TRANSPORT=http PORT=3000 MCP_AUTH_TOKEN=my-secret node dist/index.js
+```
+
+---
+
+## 集成配置
+
+### Claude Desktop
+
+编辑 Claude Desktop 配置文件（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）：
+
+```json
+{
+  "mcpServers": {
+    "wjx": {
+      "command": "node",
+      "args": ["./wjx-mcp-server/dist/index.js"],
+      "env": {
+        "WJX_APP_ID": "your_appid",
+        "WJX_APP_KEY": "your_appkey"
+      }
+    }
+  }
+}
+```
+
+> 将 `args` 中的路径替换为你本地 `dist/index.js` 的实际路径。
+
+### Claude Code
+
+```bash
+claude mcp add wjx -- node ./wjx-mcp-server/dist/index.js
+```
+
+### Cursor
+
+在项目根目录创建或编辑 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "wjx": {
+      "command": "node",
+      "args": ["./wjx-mcp-server/dist/index.js"],
+      "env": {
+        "WJX_APP_ID": "your_appid",
+        "WJX_APP_KEY": "your_appkey"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 配置项说明
+
+| 环境变量 | 必填 | 默认值 | 说明 |
+|----------|:----:|--------|------|
+| `WJX_APP_ID` | **是** | — | 问卷星 OpenAPI 开发者 ID |
+| `WJX_APP_KEY` | **是** | — | 问卷星 OpenAPI 签名密钥（与 SSO 密钥相同） |
+| `MCP_TRANSPORT` | 否 | `stdio` | 设为 `http` 启用 HTTP 传输 |
+| `PORT` | 否 | `3000` | HTTP 模式监听端口 |
+| `MCP_AUTH_TOKEN` | 否 | — | HTTP 模式的 Bearer token 认证 |
+| `MCP_SESSION` | 否 | `stateful` | 设为 `stateless` 禁用会话跟踪 |
+
+### API / SSO 地址配置
+
+所有工具调用的 URL 均可通过环境变量覆盖，方便切换测试环境或私有化部署。
+
+只需设置 `WJX_BASE_URL` 即可一键切换所有 URL 的基础域名；也可单独覆盖某个地址：
+
+| 环境变量 | 默认值 | 说明 |
+|----------|--------|------|
+| `WJX_BASE_URL` | `https://www.wjx.cn` | 所有 URL 的基础域名，其余 URL 默认从此派生 |
+| `WJX_API_URL` | `{BASE}/openapi/default.aspx` | 问卷/答卷等通用 API 地址 |
+| `WJX_USER_SYSTEM_API_URL` | `{BASE}/openapi/usersystem.aspx` | 用户体系 API 地址 |
+| `WJX_SUBUSER_API_URL` | `{BASE}/openapi/subuser.aspx` | 子账号管理 API 地址 |
+| `WJX_CONTACTS_API_URL` | `{BASE}/openapi/contacts.aspx` | 通讯录 API 地址 |
+| `WJX_SSO_SUBACCOUNT_URL` | `{BASE}/zunxiang/login.aspx` | 子账号 SSO 登录地址 |
+| `WJX_SSO_USER_SYSTEM_URL` | `{BASE}/user/loginform.aspx` | 用户体系 SSO 登录地址 |
+| `WJX_SSO_PARTNER_URL` | `{BASE}/partner/login.aspx` | 合作伙伴 SSO 登录地址 |
+| `WJX_SURVEY_CREATE_URL` | `{BASE}/newwjx/mysojump/createblankNew.aspx` | 问卷创建页地址 |
+| `WJX_SURVEY_EDIT_URL` | `{BASE}/newwjx/design/editquestionnaire.aspx` | 问卷编辑页地址 |
+
+> 表中 `{BASE}` 代表 `WJX_BASE_URL` 的值。优先级：**独立环境变量 > WJX_BASE_URL + 路径 > 硬编码默认值**。
+
+示例 — 切换到测试环境：
+
+```dotenv
+WJX_BASE_URL=https://test.wjx.cn
+```
+
+服务器内置 `.env` 加载器，无需额外安装 `dotenv`。
+
+---
+
+## HTTP 模式
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/mcp` | POST | MCP 消息端点（Streamable HTTP / SSE） |
+| `/health` | GET | 健康检查，返回 `{ status: "ok" }` |
+
+设置 `MCP_AUTH_TOKEN` 后，`/mcp` 端点要求 `Authorization: Bearer <token>` 请求头；`/health` 端点始终公开。
+
+---
+
+## 项目结构
+
+```
+wjx-mcp-server/
+├── src/
+│   ├── index.ts                  # 入口：加载 .env、选择传输模式
+│   ├── server.ts                 # createServer() — 注册模块
+│   ├── helpers.ts                # toolResult() / toolError() 工具函数
+│   ├── core/
+│   │   ├── api-client.ts         # callWjxApi() — 重试、超时、签名
+│   │   ├── sign.ts               # SHA1 排序签名
+│   │   ├── constants.ts          # Action codes、API URL、默认值
+│   │   └── types.ts              # 共享类型定义
+│   ├── modules/
+│   │   ├── survey/               # 问卷管理（12 tools）
+│   │   ├── response/             # 答卷数据（10 tools）
+│   │   ├── contacts/             # 通讯录（14 tools）
+│   │   ├── sso/                  # 免登录 URL（4 tools）
+│   │   ├── user-system/          # 用户体系（5 tools）
+│   │   ├── multi-user/           # 多用户管理（5 tools）
+│   │   └── analytics/            # 本地分析（6 tools）
+│   ├── resources/                # 8 个 MCP Resources
+│   ├── prompts/                  # 12 个 MCP Prompts
+│   └── transports/http.ts        # Streamable HTTP 传输
+├── __tests__/                    # 单元测试（node:test）
+├── tests/                        # 集成测试
+├── docs/
+│   ├── architecture.md           # 架构设计文档
+│   └── wjx-openapi-spec.md      # 问卷星 OpenAPI 参考
+├── .env.example                  # 环境变量模板
+├── CHANGELOG.md                  # 版本历史
+├── LICENSE                       # MIT License
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## 测试
+
+```bash
+# 全部测试（单元 + 集成）
+npm test
+
+# 仅单元测试
+npm run test:unit
+
+# 仅集成测试
+npm run test:integration
+```
+
+测试使用 Node.js 内置测试运行器（`node:test`），无需额外测试框架。
+
+---
+
+## 开发
+
+```bash
+npm install          # 安装依赖
+npm run build        # 编译 TypeScript
+npm test             # 运行测试
+npm run clean        # 清理 dist/
+```
+
+---
+
+## 贡献
+
+欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南。
+
+## 文档
+
+- [架构设计](docs/architecture.md) — 详细架构说明
+- [更新日志](CHANGELOG.md) — 版本历史
+- [问卷星 OpenAPI 参考](docs/wjx-openapi-spec.md) — API 规范文档
+
+## 许可证
+
+[MIT](LICENSE)

package/dist/core/api-client.d.ts

@@ -0,0 +1 @@
+export { getWjxCredentials, validateQuestionsJson, callWjxApi, callWjxUserSystemApi, callWjxSubuserApi, callWjxContactsApi, getCorpId, setCredentialProvider, } from "wjx-api-sdk";

package/dist/core/api-client.js

@@ -0,0 +1,2 @@
+export { getWjxCredentials, validateQuestionsJson, callWjxApi, callWjxUserSystemApi, callWjxSubuserApi, callWjxContactsApi, getCorpId, setCredentialProvider, } from "wjx-api-sdk";
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/core/constants.d.ts

@@ -0,0 +1 @@
+export { getWjxBaseUrl, getWjxApiUrl, getWjxUserSystemApiUrl, getWjxSubuserApiUrl, getWjxContactsApiUrl, getWjxSsoSubaccountUrl, getWjxSsoUserSystemUrl, getWjxSsoPartnerUrl, getWjxSurveyCreateUrl, getWjxSurveyEditUrl, Action, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_RETRIES, RETRY_DELAY_MS, } from "wjx-api-sdk";

package/dist/core/constants.js

@@ -0,0 +1,2 @@
+export { getWjxBaseUrl, getWjxApiUrl, getWjxUserSystemApiUrl, getWjxSubuserApiUrl, getWjxContactsApiUrl, getWjxSsoSubaccountUrl, getWjxSsoUserSystemUrl, getWjxSsoPartnerUrl, getWjxSurveyCreateUrl, getWjxSurveyEditUrl, Action, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_RETRIES, RETRY_DELAY_MS, } from "wjx-api-sdk";
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,16 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { WjxCredentials } from "./types.js";
+/**
+ * Per-request credential store.
+ *
+ * In HTTP multi-tenant mode, the transport layer extracts credentials from
+ * the incoming request (e.g. Basic auth header) and runs the MCP handler
+ * inside `credentialStore.run(creds, fn)`.  Downstream code (api-client,
+ * SSO client, …) calls `getRequestCredentials()` to retrieve them.
+ *
+ * In stdio mode (single-tenant) this store is never populated and
+ * callers fall back to environment variables — fully backward-compatible.
+ */
+export declare const credentialStore: AsyncLocalStorage<WjxCredentials>;
+/** Return request-scoped credentials, or `undefined` if not in an HTTP context. */
+export declare function getRequestCredentials(): WjxCredentials | undefined;

package/dist/core/context.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Per-request credential store.
+ *
+ * In HTTP multi-tenant mode, the transport layer extracts credentials from
+ * the incoming request (e.g. Basic auth header) and runs the MCP handler
+ * inside `credentialStore.run(creds, fn)`.  Downstream code (api-client,
+ * SSO client, …) calls `getRequestCredentials()` to retrieve them.
+ *
+ * In stdio mode (single-tenant) this store is never populated and
+ * callers fall back to environment variables — fully backward-compatible.
+ */
+export const credentialStore = new AsyncLocalStorage();
+/** Return request-scoped credentials, or `undefined` if not in an HTTP context. */
+export function getRequestCredentials() {
+    return credentialStore.getStore();
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAEvE,mFAAmF;AACnF,MAAM,UAAU,qBAAqB;IACnC,OAAO,eAAe,CAAC,QAAQ,EAAE,CAAC;AACpC,CAAC"}

package/dist/core/load-env.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/load-env.js

@@ -0,0 +1,53 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Resolve .env file path. Priority:
+ * 1. process.cwd()/.env  (npx / user working directory)
+ * 2. Package root .env   (__dirname/../../.env, for local dev)
+ */
+function findEnvFile() {
+    const cwdPath = resolve(process.cwd(), ".env");
+    if (existsSync(cwdPath))
+        return cwdPath;
+    const pkgPath = resolve(__dirname, "..", "..", ".env");
+    if (existsSync(pkgPath))
+        return pkgPath;
+    return undefined;
+}
+const envPath = findEnvFile();
+if (envPath) {
+    try {
+        const content = readFileSync(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eqIdx = trimmed.indexOf("=");
+            if (eqIdx === -1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            let value = trimmed.slice(eqIdx + 1).trim();
+            // Strip inline comments (unquoted values only)
+            if (value[0] !== '"' && value[0] !== "'") {
+                const commentIdx = value.indexOf(" #");
+                if (commentIdx !== -1)
+                    value = value.slice(0, commentIdx).trimEnd();
+            }
+            // Strip surrounding quotes (single or double)
+            if (value.length >= 2 &&
+                ((value[0] === '"' && value[value.length - 1] === '"') ||
+                    (value[0] === "'" && value[value.length - 1] === "'"))) {
+                value = value.slice(1, -1);
+            }
+            if (!(key in process.env)) {
+                process.env[key] = value;
+            }
+        }
+    }
+    catch {
+        // .env file read error — skip silently
+    }
+}
+//# sourceMappingURL=load-env.js.map

package/dist/core/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/core/load-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;;GAIG;AACH,SAAS,WAAW;IAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;AAE9B,IAAI,OAAO,EAAE,CAAC;IACZ,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,SAAS;YAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,+CAA+C;YAC/C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACzC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,UAAU,KAAK,CAAC,CAAC;oBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;YACtE,CAAC;YACD,8CAA8C;YAC9C,IACE,KAAK,CAAC,MAAM,IAAI,CAAC;gBACjB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;oBACpD,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,EACxD,CAAC;gBACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1 @@
+export type { WjxCredentials, WjxApiSuccess, WjxApiFailure, WjxApiResponse, FetchLike, Logger, RequestOptions, } from "wjx-api-sdk";

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/helpers.d.ts

@@ -0,0 +1,14 @@
+export declare function toolResult(data: unknown, isError: boolean): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function toolError(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};

package/dist/helpers.js

@@ -0,0 +1,23 @@
+export function toolResult(data, isError) {
+    let text;
+    if (data === undefined) {
+        text = isError ? '{"result":false,"errormsg":"no data"}' : "null";
+    }
+    else {
+        try {
+            text = JSON.stringify(data);
+        }
+        catch {
+            text = String(data);
+        }
+    }
+    return {
+        content: [{ type: "text", text }],
+        isError,
+    };
+}
+export function toolError(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return toolResult({ result: false, errormsg: msg }, true);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,OAAgB;IACxD,IAAI,IAAY,CAAC;IACjB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,MAAM,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import "./core/load-env.js";
+export { createServer } from "./server.js";
+export declare function main(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import "./core/load-env.js"; // Must be first — populates process.env before other modules read it
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { setCredentialProvider } from "wjx-api-sdk";
+import { getRequestCredentials } from "./core/context.js";
+import { createServer } from "./server.js";
+// Wire MCP-server's per-request credential store into the SDK
+setCredentialProvider(getRequestCredentials);
+export { createServer } from "./server.js";
+export async function main() {
+    const transportMode = process.argv.includes("--http")
+        ? "http"
+        : (process.env.MCP_TRANSPORT ?? "stdio");
+    const server = createServer();
+    if (transportMode === "http") {
+        const { startHttpTransport } = await import("./transports/http.js");
+        const port = Number(process.env.PORT ?? 3000);
+        if (!Number.isFinite(port) || port < 0 || port > 65535) {
+            throw new Error(`Invalid PORT: ${process.env.PORT}`);
+        }
+        const { httpServer } = await startHttpTransport(server, {
+            port,
+            authToken: process.env.MCP_AUTH_TOKEN,
+            stateful: process.env.MCP_SESSION !== "stateless",
+        }, createServer);
+        const shutdown = () => {
+            httpServer.close();
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    }
+    else {
+        if (!process.env.WJX_API_KEY) {
+            console.error("[wjx-mcp-server] Warning: WJX_API_KEY is not set. API calls will fail until an API key is provided.");
+        }
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        const shutdown = () => { void server.close(); };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    }
+}
+function isMainModule() {
+    try {
+        const scriptUrl = new URL(process.argv[1], "file:");
+        return (realpathSync(fileURLToPath(scriptUrl)) ===
+            realpathSync(fileURLToPath(import.meta.url)));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
+    void main().catch((error) => {
+        const message = error instanceof Error ? error.stack ?? error.message : String(error);
+        console.error(message);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/analytics/compute.d.ts

@@ -0,0 +1 @@
+export { decodeResponses, calculateNps, calculateCsat, detectAnomalies, compareMetrics, } from "wjx-api-sdk";

package/dist/modules/analytics/compute.js

@@ -0,0 +1,2 @@
+export { decodeResponses, calculateNps, calculateCsat, detectAnomalies, compareMetrics, } from "wjx-api-sdk";
+//# sourceMappingURL=compute.js.map

package/dist/modules/analytics/compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.js","sourceRoot":"","sources":["../../../src/modules/analytics/compute.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/modules/analytics/push-decode.d.ts

@@ -0,0 +1 @@
+export { decodePushPayload } from "wjx-api-sdk";

package/dist/modules/analytics/push-decode.js

@@ -0,0 +1,2 @@
+export { decodePushPayload } from "wjx-api-sdk";
+//# sourceMappingURL=push-decode.js.map

package/dist/modules/analytics/push-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-decode.js","sourceRoot":"","sources":["../../../src/modules/analytics/push-decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/modules/analytics/tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnalyticsTools(server: McpServer): void;