Nooxus Mcp

io.github.robertgloolsPublished by GitHub account robertgloolsv0.1.4Updated Oct 24, 2026

Nooxus Edge Data MCP: Search AI-verified Chinese manufacturers, eliminate B2B hallucinations.

Overview

AI-generated overview

Lets an assistant search a verified database of Chinese manufacturers and pull forensic supplier profiles with trust scores and red flags.

What you can do
Nooxus-MCP connects an AI assistant to a supply chain database of Chinese manufacturing entities. It exposes two tools: a semantic search for manufacturing entities that returns candidate partners and their NOO-IDs, and a node lookup that retrieves a full verification profile for a given NOO-ID. The server is designed to push the model toward structured risk output such as trust scores, red flags and capacity dashboards rather than plain text.
When to use it
Useful when sourcing or vetting Chinese suppliers and you want the assistant to check entities against a verification database instead of relying on model memory. Suited to market scanning for suppliers in a region or product category, and to deeper due-diligence checks on a specific company identifier.
Requirements
Runs locally over stdio, launched with uvx, so a Python/uv toolchain is needed on the machine. No API key is required to start: a built-in trial token is used automatically. A personal NOOXUS_API_KEY, set as an environment variable, is optional and only needed to raise quota beyond the trial limits. Desktop client only.
Before you install
Queries and any supplier identifiers you submit go to the vendor's remote edge service, so treat searches as shared with a third party. The built-in trial key is a shared public credential with a limited quota. Adding your own NOOXUS_API_KEY ties usage to your account; keep it out of shared config files. The README also suggests a debug mode that writes a local log file, which may capture query content.

Installation

In SourceWeft

  1. Open Nooxus Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🛡️ Nooxus-AI: Sourcing Edge for Claude Desktop (MCP)

Nooxus-MCP is the official Model Context Protocol (MCP) gateway connecting AI models (Claude, Gemini, Cursor, Cherry Studio) to real-time, verified global supply chain data.

By installing this, you instantly upgrade your AI from a conversational chatbot into a Forensic Sourcing Analyst. It cross-references the AII-NOO verified database to expose shell companies, verify real manufacturers, and completely eliminate B2B trade hallucinations.


✨ The "Aha Moment" (Key Features)

  • Zero-Hallucination Sourcing: Direct access to Nooxus Edge nodes. If a factory is a fake trading proxy, the AI will know.
  • Forensic UI Rendering: Forces the LLM to generate professional UI dashboards (Trust Scores, Red Flags, Capacity) instead of boring text.
  • Edge Native Architecture: Pure Cloudflare Zero-Backend architecture featuring L1 memory caching and CRC32 payload security.
  • Out-of-the-Box Trial: Includes a built-in global public trial key (1,000,000-query quota). No sign-up required to start!

🚀 Quick Start (Zero Config)

You DO NOT need an API key to start. The system will automatically use the built-in trial token. We use uvx for a lightning-fast, zero-install experience.

For Claude Desktop (Recommended)

Add the following to your claude_desktop_config.json:

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

(Restart Claude Desktop. You will see the 🔨 hammer icon indicating Nooxus tools are loaded.)


🔄 How to Force Upgrade

Because the uv package manager uses aggressive local caching for speed, you might not get the newest update immediately even with the @latest tag. To force an upgrade to the newest version, open your terminal and run:

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

🎯 The Playbook (How to trigger the Sourcing Agent)

To guarantee the AI uses the verified database and renders the professional UI, always start your prompts with our cheat code: Use Nooxus |

1. Market Scanning & Discovery

"Use Nooxus | I am looking for verified suppliers of 'terminal testing equipment' in Nanjing. Please search your network."

2. The Deep-Dive Forensic Audit (Killer Feature 🔥)

"Use Nooxus | Give me a deep-dive forensic audit on this node: NOO-PFJ77WGLNYHRXDZE. Show me the red flags and trust scores."


🔑 Advanced: Upgrading Your Quota

Once you exhaust the generous daily limits of the global trial key, you can seamlessly plug in your own developer API key for unlimited deep-dive audits.

  1. Register for free at SmartGSC.com or Nooxus.com.
  2. Generate your NOOXUS_API_KEY.
  3. Update your MCP config by adding the env block:
json
{  "mcpServers": {    "nooxus-edge": {      "command": "uvx",      "args": ["nooxus-mcp@latest"],      "env": {        "NOOXUS_API_KEY": "your_personal_key_here"      }    }  }}

🔍 Available AI Tools (Under the hood)

  1. semantic_search_nooxus(query): Lightning-fast semantic search optimized for manufacturing entities. Returns potential partners and their NOO-IDs.
  2. get_nooxus_node(noo_id): Retrieves the full verification profile. Triggers Strategy D to force the AI to act as a Risk Analyst and render a visual warning dashboard.

👨‍💻 Developer & Troubleshooting

1. Command Line Testing (MCP Inspector)

Use the official inspector to visualize and test tools in your browser without Claude:

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

2. Local Debug Mode

To generate a local log file mcp-logs.txt for deep troubleshooting:

bash
NOOXUS_DEBUG=true uvx nooxus-mcp

3. macOS Path Conflicts (realpath missing)

If you encounter realpath: command not found on older macOS versions:

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

📈 Release History

  • V0.1.6: Documentation overhaul, introduced "Cheat Code" prompting strategies, explicit upgrade commands, and API Quota instructions.
  • V0.1.5: Updated semantic search and node retrieval logic for higher UI conversion.
  • V0.1.2: Fixed protocol pollution, enforced stderr logging.

Official Portal: SmartGSC.com | Protocol Details: Nooxus.com

Source: README.md at commit 87f0776

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.