{"_id":"@aweray/ewei-mcp-server","name":"@aweray/ewei-mcp-server","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@aweray/ewei-mcp-server","version":"0.0.1","description":"易维帮助台 MCP Server，支持查询与操作工单、回复、客户、客服、附件等","license":"MIT","type":"module","bin":{"ewei-mcp-server":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","typecheck":"tsc --noEmit","test":"tsx src/token/codec.test.ts","start":"node dist/index.js","start:http":"node dist/index.js --transport=streamable_http","dev":"tsx src/index.ts","dev:http":"tsx src/index.ts --transport=streamable_http","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/node":"^2.0.0","@modelcontextprotocol/server":"^2.0.0","zod":"^4.0.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.0.0","typescript":"^5.5.0"},"gitHead":"6c101dc73b42d930f3d3adce7ebffb87a0545b0b","_id":"@aweray/ewei-mcp-server@0.0.1","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-jJslNKYJ+yzVsdGrI1gc3KtbpQsJ0qt3xaIbc/tejVYzL6buONWzWrMQ1gTsLOhjbC4KkGh3Ac2BUq5lTmtgDQ==","shasum":"9ec1f9dc8c793d19a07ecc83ffa79adc7a2ae635","tarball":"https://registry.npmjs.org/@aweray/ewei-mcp-server/-/ewei-mcp-server-0.0.1.tgz","fileCount":182,"unpackedSize":243383,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC9ng1/2fT5f6xcx9a4WN9gWI3Y+TDyH25kvJcnI77YbQIhANLr1fUw7CElPPDidRMSL0ppmSFf7j+/E8Z8ge+Tqi/N"}]},"_npmUser":{"name":"wenzewoo","email":"wenzewoo@gmail.com"},"directories":{},"maintainers":[{"name":"zhuozhibin","email":"zhuozhibin_8315@oray.com"},{"name":"wenzewoo","email":"wenzewoo@gmail.com"},{"name":"liuchanghuang","email":"liuchanghuang1@oray.com"},{"name":"ordev-npm","email":"dev@oray.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ewei-mcp-server_0.0.1_1786413550459_0.5786487255925297"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-11T01:59:10.239Z","0.0.1":"2026-08-11T01:59:10.606Z","modified":"2026-08-11T01:59:10.897Z"},"maintainers":[{"name":"zhuozhibin","email":"zhuozhibin_8315@oray.com"},{"name":"wenzewoo","email":"wenzewoo@gmail.com"},{"name":"liuchanghuang","email":"liuchanghuang1@oray.com"},{"name":"ordev-npm","email":"dev@oray.com"}],"description":"易维帮助台 MCP Server，支持查询与操作工单、回复、客户、客服、附件等","license":"MIT","readme":"# @aweray/ewei-mcp-server\n\n易维帮助台 MCP Server，支持通过 AI 助手直接查询和操作易维帮助台的工单、客户、客服等信息。\n\n## 功能\n\n覆盖工单全生命周期、客户、客服与基础资料管理：\n\n| 能力域 | 工具 | 说明 |\n| --- | --- | --- |\n| **工单查询** | `ticket_info` | 获取指定工单的详情 |\n| | `ticket_list` | 高级查询：按状态/优先级/请求人/客服/客服组/渠道/时间范围等多条件组合，支持关键字检索 |\n| | `ticket_log_list` | 获取工单日志/时间轴，可按「仅回复」「仅操作日志」过滤 |\n| **工单处理** | `ticket_create` | 创建工单，支持设置请求人、客服、客服组、自定义字段、附件等 |\n| | `ticket_update` | 修改工单主题/描述/优先级/请求人/类型/标签/自定义字段 |\n| | `ticket_assign` | 分派工单到客服或客服组，可同时附加一条回复 |\n| | `ticket_delete` | 删除工单 |\n| **回复** | `ticket_comment_list` | 查看工单的回复列表 |\n| | `ticket_comment_create` | 添加工单回复，可控制客户可见性，支持附加附件，可同时修改工单状态（new/open/pending/solved） |\n| **客户管理** | `customer_list` | 按关键字检索客户 |\n| | `customer_info` | 获取客户详情，支持客户 id / email / 手机号 / 第三方 openId 多种方式查询 |\n| | `customer_create` | 创建客户，支持自定义字段 |\n| | `customer_update` | 修改客户，支持自定义字段 |\n| | `customer_delete` | 删除客户 |\n| | `customer_group_list` / `customer_group_create` | 客户组查询与创建 |\n| **客服管理** | `engineer_list` | 客服列表 |\n| | `engineer_info` | 客服详情，支持 id / email / 手机号查询，附带在线状态 |\n| **基础资料** | `service_desk_list` | 客服组（服务台）列表 |\n| | `service_catalog_list` | 服务目录列表 |\n| | `ticket_type_list` | 工单类型列表 |\n| | `custom_field_list` | 自定义字段列表（工单/客户/客户组），默认工单作用域 |\n| **附件** | `attachment_upload` | 上传附件（支持源 URL 或 base64） |\n| | `attachment_download` | 获取附件的真实下载地址 |\n| | `attachment_info` | 查询附件信息 |\n| | `attachment_delete` | 删除附件 |\n\n工具命名统一为 `{资源}_{动作}`，同资源工具聚合，方便 Agent 按领域调用。\n\n## 配置\n\n启动本 MCP Server 只需两样东西：**一条启动命令 + 一个环境变量**。\n\n- **启动命令**：`npx -y @aweray/ewei-mcp-server`\n- **环境变量**：`EWEI_MCP_SERVER_TOKEN=<token>`，token 从工单系统后台复制，用于认证请求工单系统。\n\n\n在 AI 客户端中按此填入即可。下面以 Claude Code、opencode 为例，其他 MCP 客户端（Cursor、Zed、VS Code 等）配置方式类似。\n\n### Claude Code\n\n在项目根目录创建 `.mcp.json`（无需额外安装，Claude Code 会自动加载）：\n\n```json\n{\n  \"mcpServers\": {\n    \"ewei-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aweray/ewei-mcp-server\"],\n      \"env\": {\n        \"EWEI_MCP_SERVER_TOKEN\": \"<token>\"\n      }\n    }\n  }\n}\n```\n\n- `command` / `args`：启动命令，一般保持默认\n- `env`：注入 MCP Server 进程的环境变量，将 `<token>` 替换为从工单系统后台复制的 token\n\n### opencode\n\n编辑 `opencode.json`（项目根目录，或全局配置 `~/.config/opencode/opencode.json`），在 `mcp` 下新增一项：\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"ewei-mcp-server\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@aweray/ewei-mcp-server\"],\n      \"environment\": {\n        \"EWEI_MCP_SERVER_TOKEN\": \"<token>\"\n      }\n    }\n  }\n}\n```\n\n- `type: \"local\"`：本地子进程方式运行\n- `command`：启动命令，数组形式\n- `environment`：注入的环境变量，将 `<token>` 替换为从工单系统后台复制的 token\n","readmeFilename":"README.md","_rev":"1-c99f9f894164290d1c6f5d2c36074ca7"}