{
  "markdown": "# 🛡️ Nooxus-AI: Sourcing Edge for Claude Desktop (MCP)\n\n[](https://modelcontextprotocol.io)\n[](https://pypi.org/project/nooxus-mcp/)\n[](https://opensource.org/licenses/MIT)\n\n**Nooxus-MCP** is the official [Model Context Protocol (MCP)](https://modelcontextprotocol.io) gateway connecting AI models (Claude, Gemini, Cursor, Cherry Studio) to **real-time, verified global supply chain data**. \n\nBy 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.\n\n---\n\n## ✨ The \"Aha Moment\" (Key Features)\n\n- **Zero-Hallucination Sourcing:** Direct access to Nooxus Edge nodes. If a factory is a fake trading proxy, the AI will know.\n- **Forensic UI Rendering:** Forces the LLM to generate professional UI dashboards (Trust Scores, Red Flags, Capacity) instead of boring text.\n- **Edge Native Architecture:** Pure Cloudflare Zero-Backend architecture featuring L1 memory caching and CRC32 payload security.\n- **Out-of-the-Box Trial:** Includes a built-in global public trial key (1,000,000-query quota). **No sign-up required to start!**\n\n---\n\n## 🚀 Quick Start (Zero Config)\n\nYou 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.\n\n### For Claude Desktop (Recommended)\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"nooxus-edge\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nooxus-mcp@latest\"]\n    }\n  }\n}\n```\n*(Restart Claude Desktop. You will see the 🔨 hammer icon indicating Nooxus tools are loaded.)*\n\n---\n\n## 🔄 How to Force Upgrade\n\nBecause 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:\n\n```bash\nuvx --refresh nooxus-mcp@latest --version\n```\n\n---\n\n## 🎯 The Playbook (How to trigger the Sourcing Agent)\n\nTo guarantee the AI uses the verified database and renders the professional UI, always start your prompts with our cheat code: **`Use Nooxus | `**\n\n**1. Market Scanning & Discovery**\n> *\"Use Nooxus | I am looking for verified suppliers of 'terminal testing equipment' in Nanjing. Please search your network.\"*\n\n**2. The Deep-Dive Forensic Audit (Killer Feature 🔥)**\n> *\"Use Nooxus | Give me a deep-dive forensic audit on this node: NOO-PFJ77WGLNYHRXDZE. Show me the red flags and trust scores.\"*\n\n---\n\n## 🔑 Advanced: Upgrading Your Quota\n\nOnce 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.\n\n1. Register for free at [SmartGSC.com](https://smartgsc.com) or [Nooxus.com](https://nooxus.com).\n2. Generate your `NOOXUS_API_KEY`.\n3. Update your MCP config by adding the `env` block:\n\n```json\n{\n  \"mcpServers\": {\n    \"nooxus-edge\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nooxus-mcp@latest\"],\n      \"env\": {\n        \"NOOXUS_API_KEY\": \"your_personal_key_here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## 🔍 Available AI Tools (Under the hood)\n\n1. **`semantic_search_nooxus(query)`**: Lightning-fast semantic search optimized for manufacturing entities. Returns potential partners and their NOO-IDs.\n2. **`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.\n\n---\n\n## 👨‍💻 Developer & Troubleshooting\n\n### 1. Command Line Testing (MCP Inspector)\nUse the official inspector to visualize and test tools in your browser without Claude:\n```bash\nnpx @modelcontextprotocol/inspector uvx --refresh nooxus-mcp\n```\n\n### 2. Local Debug Mode\nTo generate a local log file `mcp-logs.txt` for deep troubleshooting:\n```bash\nNOOXUS_DEBUG=true uvx nooxus-mcp\n```\n\n### 3. macOS Path Conflicts (`realpath` missing)\nIf you encounter `realpath: command not found` on older macOS versions:\n```bash\nbrew install coreutils\nexport PATH=\"/usr/local/opt/coreutils/libexec/gnubin:$PATH\"\n```\n\n---\n\n## 📈 Release History\n- **V0.1.6**: Documentation overhaul, introduced \"Cheat Code\" prompting strategies, explicit upgrade commands, and API Quota instructions.\n- **V0.1.5**: Updated semantic search and node retrieval logic for higher UI conversion.\n- **V0.1.2**: Fixed protocol pollution, enforced stderr logging.\n\n---\n**Official Portal:** [SmartGSC.com](https://smartgsc.com) | **Protocol Details:** [Nooxus.com](https://nooxus.com)",
  "bytes": 4634,
  "sha": "7792e66d3696d14b33d75aa3d5823f20f97cc7b9b74401f9896db7e9a4ef6cd2",
  "repo_slug": "nooxus-ai/nooxus-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_robertglools_nooxus_mcp_59899672/readme"
}