tenable-mcp-docs 1.0.0

package/README.md

@@ -0,0 +1,169 @@
+# Tenable Docs MCP Server (npx Package)
+
+Run the Tenable Docs MCP server directly with `npx` - no installation required!
+
+## What is this?
+
+This is an **npx launcher** for the [tenable-docs-mcp](https://github.com/CatFoxVoyager/tenable-mcp-docs) server. It downloads the latest version from GitHub and runs it immediately.
+
+## Quick Start
+
+```bash
+# Run immediately with npx
+npx tenable-mcp-docs
+
+# Or with debug output
+DEBUG=1 npx tenable-mcp-docs
+```
+
+That's it! No npm install, no git clone, just run and go.
+
+## What is npx?
+
+**npx** is a package runner that:
+- Downloads packages temporarily
+- Executes them immediately
+- Doesn't require global installation
+- Always uses the latest version
+
+Perfect for testing or one-time use!
+
+## Configuration
+
+### Claude Desktop (Recommended)
+
+Add to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "tenable-docs": {
+      "command": "npx",
+      "args": ["tenable-mcp-docs"]
+    }
+  }
+}
+```
+
+### Other MCP Clients
+
+Any MCP client that supports npx can use this package. The command is:
+
+```bash
+npx tenable-mcp-docs
+```
+
+## How it Works
+
+1. **Download**: Script fetches `dist/index.js` from GitHub main branch
+2. **Execute**: Node.js runs the downloaded server
+3. **Cleanup**: Temporary file deleted after process ends
+4. **Update**: Next run downloads the latest version
+
+### Advantages
+
+- ✅ **No Installation**: Works immediately without `npm install`
+- ✅ **Always Latest**: Gets the newest version from GitHub
+- ✅ **No Local Files**: Doesn't clutter your filesystem
+- ✅ **Easy Updates**: Always runs the latest code
+- ✅ **Simple**: One command to run
+
+### Network Requirements
+
+- Internet connection (to download from GitHub)
+- HTTPS access to `raw.githubusercontent.com`
+
+## Available Tools
+
+The server provides two MCP tools:
+
+### 1. search_docs
+
+Search Tenable documentation for relevant pages.
+
+**Usage in Claude:**
+```
+User: How do I use the Tenable API?
+Claude: Let me search the documentation...
+[calls search_docs with "Tenable API"]
+```
+
+### 2. read_page
+
+Read a documentation page and convert to Markdown.
+
+**Usage in Claude:**
+```
+Claude: I found relevant documentation. Let me read it...
+[calls read_page with documentation URL]
+Claude: Here's the information from the documentation...
+```
+
+## Troubleshooting
+
+### "npx: command not found"
+
+**Cause**: npx is not installed or not in PATH
+
+**Solution**: npx comes with npm. Install [Node.js](https://nodejs.org/).
+
+### "Failed to download server"
+
+**Cause**: No internet connection or GitHub is down
+
+**Solution**:
+1. Check internet connection
+2. Try accessing https://raw.githubusercontent.com/CatFoxVoyager/tenable-mcp-docs/main/dist/index.js
+3. Check GitHub status: https://status.github.com/
+
+### "Node.js is not installed"
+
+**Solution**: Install Node.js from https://nodejs.org/
+
+### Server Won't Start
+
+**Cause**: Downloaded file is corrupted or incompatible Node version
+
+**Solution**:
+1. Ensure Node.js 18+ is installed
+2. Check Node version: `node --version`
+3. Try running with debug: `DEBUG=1 npx tenable-mcp-docs`
+
+## Development
+
+If you want to develop or modify the server:
+
+```bash
+# Clone the main repository
+git clone https://github.com/CatFoxVoyager/tenable-mcp-docs
+cd tenable-mcp-docs
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start
+```
+
+See the main repository for documentation and contribution guidelines.
+
+## License
+
+MIT License
+
+## Links
+
+- [Main Repository](https://github.com/CatFoxVoyager/tenable-mcp-docs)
+- [npm Package](https://www.npmjs.com/package/tenable-mcp-docs)
+- [Tenable Developer Portal](https://developer.tenable.com/)
+- [MCP Documentation](https://modelcontextprotocol.io/)
+
+---
+
+**Made with ❤️ for the Tenable developer community**

package/bin/tenable-mcp-docs

@@ -0,0 +1,46 @@
+#!/bin/sh
+
+# Tenable Docs MCP Server Launcher
+# This script downloads and executes the server from GitHub
+
+set -e
+
+# Colors for output
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Server download URL
+SERVER_URL="https://raw.githubusercontent.com/CatFoxVoyager/tenable-mcp-docs/main/dist/index.js"
+TEMP_DIR="${TMPDIR:-/tmp}"
+SERVER_FILE="${TEMP_DIR}/tenable-mcp-docs-server.js"
+
+echo -e "${GREEN}Tenable Docs MCP Server${NC}"
+echo "================================"
+echo ""
+
+# Check if Node.js is available
+if ! command -v node &> /dev/null; then
+    echo "Error: Node.js is not installed or not in PATH"
+    echo "Please install Node.js from https://nodejs.org/"
+    exit 1
+fi
+
+NODE_VERSION=$(node --version)
+echo "Node.js version: ${NODE_VERSION}"
+echo ""
+
+# Download the server
+echo "Downloading server from GitHub..."
+curl -fsSL "${SERVER_URL}" -o "${SERVER_FILE}"
+
+if [ $? -ne 0 ]; then
+    echo "Error: Failed to download server"
+    echo "Please check your internet connection"
+    exit 1
+fi
+
+echo "Server downloaded successfully"
+echo ""
+
+# Execute the server with all arguments
+exec node "${SERVER_FILE}" "$@"

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "tenable-mcp-docs",
+  "version": "1.0.0",
+  "description": "MCP server for retrieving Tenable documentation to assist with script generation. Run via npx to use immediately without installation.",
+  "bin": {
+    "tenable-mcp-docs": "bin/tenable-mcp-docs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tenable",
+    "documentation",
+    "api"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CatFoxVoyager/tenable-mcp-docs"
+  },
+  "homepage": "https://github.com/CatFoxVoyager/tenable-mcp-docs#readme"
+}