nooxus-mcp

🛡️ Nooxus-AI：Claude Desktop 的采购优势（MCP）

Nooxus-MCP 是官方 Model Context Protocol (MCP) 网关，可将 AI 模型（Claude、Gemini、Cursor、Cherry Studio）连接到实时、经过验证的全球供应链数据。

安装后，你即可将 AI 从对话聊天机器人升级为取证采购分析师。它会交叉比对 AII-NOO 验证数据库，揭露空壳公司、核实真实制造商，并彻底消除 B2B 贸易幻觉。

---

✨ “顿悟时刻”（核心功能）

• 零幻觉采购： 直接访问 Nooxus Edge 节点。如果某家工厂是假冒的贸易代理，AI 会识别出来。
• 取证 UI 渲染： 强制 LLM 生成专业 UI 仪表板（信任评分、风险信号、产能），而不是枯燥的文本。
• 边缘原生架构： 纯 Cloudflare 零后端架构，采用 L1 内存缓存和 CRC32 载荷安全机制。
• 开箱即用的试用版： 内置全球公用试用密钥（配额为 1,000,000 次查询）。无需注册即可开始使用！

---

🚀 快速开始（零配置）

开始使用无需 API 密钥。系统会自动使用内置试用令牌。我们使用 uvx，实现闪电般快速、无需安装的体验。

适用于 Claude Desktop（推荐）

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "nooxus-edge": {
      "command": "uvx",
      "args": ["nooxus-mcp@latest"]
    }
  }
}

（重启 Claude Desktop。看到 🔨 锤子图标即表示 Nooxus 工具已加载。）

---

🔄 如何强制升级

由于 uv 包管理器采用积极的本地缓存以提升速度，即使使用 @latest 标签，你也可能无法立即获取最新更新。如需强制升级到最新版本，请打开终端并运行：

uvx --refresh nooxus-mcp@latest --version

---

🎯 使用指南（如何触发采购 Agent）

为确保 AI 使用经过验证的数据库并渲染专业 UI，请始终在提示词开头使用我们的快捷口令：Use Nooxus |

1. 市场扫描与发现

"Use Nooxus | 我正在南京寻找经过验证的“终端测试设备”供应商。请搜索你的网络。"

2. 深入取证审计（杀手级功能 🔥）

"Use Nooxus | 请对这个节点进行深入取证审计：NOO-PFJ77WGLNYHRXDZE。向我展示风险信号和信任评分。"

---

🔑 进阶：升级配额

用完全球试用密钥慷慨的每日额度后，你可以无缝接入自己的开发者 API 密钥，以进行不限量的深入审计。

1. 在 SmartGSC.com 或 Nooxus.com 免费注册。
2. 生成你的 NOOXUS_API_KEY。
3. 添加 env 块以更新你的 MCP 配置：

{
  "mcpServers": {
    "nooxus-edge": {
      "command": "uvx",
      "args": ["nooxus-mcp@latest"],
      "env": {
        "NOOXUS_API_KEY": "your_personal_key_here"
      }
    }
  }
}

---

🔍 可用的 AI 工具（底层机制）

1. semantic_search_nooxus(query)：针对制造业实体优化的闪电般快速语义搜索。返回潜在合作伙伴及其 NOO-ID。
2. get_nooxus_node(noo_id)：获取完整的验证档案。触发 Strategy D，强制 AI 充当风险分析师并渲染可视化预警仪表板。

---

👨‍💻 开发者与故障排查

1. 命令行测试（MCP Inspector）

使用官方 Inspector，无需 Claude 即可在浏览器中查看和测试工具：

npx @modelcontextprotocol/inspector uvx --refresh nooxus-mcp

2. 本地调试模式

如需生成本地日志文件 mcp-logs.txt 以进行深入故障排查：

NOOXUS_DEBUG=true uvx nooxus-mcp

3. macOS 路径冲突（缺少 realpath）

如果在较旧的 macOS 版本上遇到 realpath: command not found：

brew install coreutils
export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"

---

📈 发布历史

• V0.1.6：全面改版文档，新增「Cheat Code」提示词策略、明确的升级命令和 API 配额说明。
• V0.1.5：更新语义搜索和节点检索逻辑，以提高 UI 转化率。
• V0.1.2：修复协议污染问题，强制将日志写入 stderr。

---

官方门户： SmartGSC.com | 协议详情： Nooxus.com