NX Audit MCP Server

基于 MCP (Model Context Protocol) 的远程图片内容审核服务，对接 NX Image API，为 Claude Code / Cherry Studio 等 MCP 客户端提供图片鉴黄、政治、暴恐识别能力。

---

工具列表

工具	说明
nx_img_audit	图片内容审核，支持 HTTP URL / 本地路径 / dataUrl，返回每张图片的风险等级和命中标签

---

nx_img_audit 参数

参数	类型	必填	说明
urls	string[]	与 files 二选一	网络图片 HTTP(S) 链接列表
files	string[]	与 urls 二选一	本地图片 dataUrl 列表（data:image/...;base64,...）。远程调用传本地图片用此参数
apiKey	string	否	API Key（可选）。不传则使用服务端环境变量 NX_API_KEY

urls 和 files 可同时传，服务端自动识别格式，合并后逐张审核。

---

返回格式

{
  "success": true,
  "message": "审核完成: 通过 3, 违规 0, 失败 0",
  "items": [
    {
      "url": "https://example.com/image.jpg",
      "safe": true,
      "errcode": 0,
      "errmsg": "",
      "source": "api",
      "message": "检测通过"
    }
  ],
  "summary": {
    "total": 3,
    "pass": 3,
    "block": 0,
    "error": 0
  }
}

字段	类型	说明
success	boolean	全部通过且无失败时为 true
items[].safe	boolean	true 通过 / false 违规
items[].errcode	number	审核结果码，0 为正常
items[].errmsg	string	审核结果描述，命中敏感内容时列出标签
items[].error	string	请求失败时的错误信息（仅失败项有此字段）
summary	object	汇总统计：total / pass / block / error

---

传入内容限制

传入方式	本地 MCP（Stdio / localhost HTTP）	远程 MCP	说明
HTTP(S) URL	✅	✅	远程唯一可用方式
本地绝对路径 C:\... /path/...	✅	❌	MCP Server 直接读磁盘
data URL data:image/...;base64,...	✅	✅	HTTP 模式默认 50MB body 限制

---

API Key 配置

获取 Key 请联系微信 zhjian_2026。

优先级：工具参数 apiKey > 环境变量 NX_API_KEY

方式一：环境变量（推荐）

服务端启动时设置：

NX_API_KEY=sk-your-key npm run start:http

魔塔等云平台在实例管理的环境变量处填入 NX_API_KEY。

方式二：Stdio MCP 客户端 env 字段

{
  "mcpServers": {
    "nx-mcp-audit": {
      "command": "node",
      "args": ["path/to/src/index.js"],
      "env": {
        "NX_API_KEY": "your-key"
      }
    }
  }
}

方式三：工具参数显式传入

调用 nx_img_audit 时传入 apiKey 参数，适合需要在请求级别覆盖 Key 的场景。

---

快速开始

环境要求

• Node.js >= 18.0.0

安装

git clone <repo-url>
cd mcp-server
npm install

启动

Stdio 模式（默认，本地 MCP 客户端）：

NX_API_KEY=sk-your-key npm start

HTTP 模式（远程调用 / 云部署）：

NX_API_KEY=sk-your-key npm run start:http
# → http://0.0.0.0:3000/mcp
# → http://localhost:3000/health

MCP 客户端配置

HTTP 模式（Claude Code / 远程客户端）：

{
  "mcpServers": {
    "nx-mcp-audit": {
      "type": "streamable_http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

URL 无需附带鉴权参数，Key 由服务端环境变量 NX_API_KEY 提供。

---

传输模式

模式	环境变量	适用
Stdio（默认）	不设	Claude Code、Cherry Studio 本地
HTTP	MCP_TRANSPORT=http	云端托管、远程调用

---

环境变量

变量	说明	默认值
NX_API_KEY	审核 API 鉴权 Key	-
NX_API_BASE_URL	API 服务地址	https://ai.nxtici.com
MCP_TRANSPORT	传输模式：stdio / http	stdio
MCP_PORT	HTTP 模式端口	3000
MCP_BODY_LIMIT	HTTP body 大小限制	50mb

---

错误响应

失败时返回 isError: true，content[0].text 为 JSON：

{
  "error": "未配置 API Key",
  "code": "MISSING_API_KEY",
  "help": "请设置环境变量 NX_API_KEY 或传入 apiKey 参数。获取 Key 请联系微信 zhjian_2026。",
  "doc": ""
}

字段	说明
error	错误描述
code	错误码，用于程序判断
help	建议/帮助信息
doc	文档链接（可选）

常见错误码：

code	说明
MISSING_API_KEY	未配置 API Key
MISSING_PARAMS	缺少 urls/files 参数
FILE_NOT_FOUND	本地文件不存在
DOWNLOAD_FAILED	远程图片下载失败
NETWORK_ERROR	网络请求失败
REQUEST_TIMEOUT	审核请求超时（180s）
API_AUTH_FAILED	API Key 无效
API_MISSING_AUTH	缺少认证头

---

版本标识

部署后可通过 MCP initialize 响应的 serverInfo.version 确认当前版本：

"serverInfo": {"name": "nx-audit-mcp-server", "version": "1.0.13"}

---

注意事项

1. 远程 MCP 只能传 HTTP(S) 链接或 dataUrl
2. 本地 MCP 可传绝对路径，Server 直接读磁盘
3. 多张图片逐张审核，单张失败不影响其他
4. 超时 180 秒

---

项目结构

src/
├── index.js            # MCP Server 入口（Stdio / HTTP 双模式）
├── tools/
│   ├── definitions.js  # MCP 工具定义（inputSchema）
│   └── handlers.js     # 工具处理函数路由
├── audit-api.js        # NX 审核 API 客户端
├── config.js           # 配置加载（环境变量 / config.json）
└── errors.js           # 统一错误类 NxError

依赖

• @modelcontextprotocol/sdk — MCP 协议
• express — HTTP 传输模式

License

MIT