[{"_1":2,"_300":-5,"_301":-5},"loaderData",{"_3":4,"_24":25,"_206":207},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",26956153,"membership","referenceId","019aaa59-d4ed-74ec-91a5-a5958f55d5bf","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":43,"_124":125,"_205":111},"availableLocales",[],"githubUser","locale",{"_31":32,"_39":40,"_41":42},"mcpServer",{"_33":34,"_35":36,"_37":38},"description","Enables network scanning and security assessment using Nmap through MCP, allowing AI assistants to perform port scans, service detection, and network reconnaissance on specified targets with configurable scan parameters.","displayName","Nmap MCP Server","readme","# Nmap MCP Server (Smithery SDK)\n\nThis project implements an MCP-compliant (Model Context Protocol) server using the Smithery SDK. It wraps the Nmap network scanner, exposing its functionality as callable tools within the MCP framework.\n\n## Features\n\n- **MCP Standard Endpoint (`/mcp`)**: Interacts with the server using JSON-RPC 2.0 requests.\n- **`nmapScan` Tool**: Initiates an Nmap scan on a specified target with configurable flags. Returns detailed scan results, including parsed XML output.\n- **`getInfo` Tool**: Provides basic information about the Nmap service and its capabilities.\n- Input validation for targets and Nmap flags to enhance security.\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) (v16.x or later recommended)\n- [Nmap](https://nmap.org/download.html) installed and available in your system's PATH.\n\n## Installation\n\n1. Clone the repository (or download the source code).\n2. Navigate to the project directory:\n ```bash\n cd your-project-directory\n ```\n3. Install dependencies:\n ```bash\n npm install\n ```\n\n## Running the Server\n\nTo start the server, run:\n\n```bash\nnpm start\n```\n\nBy default, the server will listen on `http://localhost:5001`. You can set the `PORT` environment variable to use a different port.\n\n## Interacting with the Server (MCP)\n\nAll interactions with the server are done via the `/mcp` endpoint using JSON-RPC 2.0. You will send `POST` requests with a `Content-Type: application/json` header.\n\n### Calling the `nmapScan` Tool\n\nTo initiate an Nmap scan:\n\n**Request Body (JSON):**\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1, // Or any unique request ID\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"nmapScan\",\n \"arguments\": {\n \"target\": \"scanme.nmap.org\",\n \"flags\": \"-A -T4\" // Optional, defaults to \"-T4 -p 1-1000\"\n }\n }\n}\n```\n\n**Example using cURL:**\n\n```bash\ncurl -X POST http://localhost:5001/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json, text/event-stream\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"nmapScan\",\n \"arguments\": {\n \"target\": \"scanme.nmap.org\",\n \"flags\": \"-A\"\n }\n }\n }'\n```\n\n**Expected Response Structure (Success):**\n\nThe server will respond with the results of the Nmap scan. The `content` array will contain a text object with a summary and the full JSON-parsed Nmap XML output.\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Nmap Scan Results for scanme.nmap.org\\n\\nScan started: ...\\n... (summary of open ports) ...\\nScan completed: ...\\n\\nFull XML Output:\\n{\\n \\\"nmaprun\\\": { ... }\\n}\"\n }\n ]\n }\n}\n```\n\nIf the scan fails or inputs are invalid, the `text` field will contain an error message.\n\n### Calling the `getInfo` Tool\n\nTo get information about the service:\n\n**Request Body (JSON):**\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 2,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"getInfo\",\n \"arguments\": {}\n }\n}\n```\n\n**Example using cURL:**\n\n```bash\ncurl -X POST http://localhost:5001/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Accept: application/json, text/event-stream\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"id\": 2,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"getInfo\",\n \"arguments\": {}\n }\n }'\n```\n\n**Expected Response Structure (Success):**\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 2,\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Nmap Service Information:\\n- Service: Network scanning using Nmap\\n- Version: 1.0.0\\n- Available Tools: nmapScan, getInfo\\n- Session ID: N/A\\n- Supported Targets: Domain names, IP addresses, CIDR notation\\n- Security: Input validation and command sanitization enabled\"\n }\n ]\n }\n}\n```\n\n## Deployment on Smithery\n\nTo deploy this server on Smithery, you will typically need to:\n\n1. **Ensure Nmap is available in the Smithery execution environment.** This might involve custom Docker images or buildpacks if Nmap isn't pre-installed.\n2. **Define the startup command:** Smithery will need to know how to start the application (e.g., `npm start`).\n3. **Port configuration:** Smithery will expose the application, usually handling port mapping. Ensure the application listens on the port Smithery expects (often configured via the `PORT` environment variable, which this server supports via the `process.env.PORT || 5001` pattern).\n4. **Package the application:** This usually means providing the source code and `package.json` (and `package-lock.json`). Smithery will then build the application, installing dependencies.\n\nRefer to the Smithery documentation for specific deployment instructions and how to configure services that adhere to the Model Context Protocol.\n\n## Example MCP Client\n\nBelow is an example of how to create a client to interact with this Nmap MCP server. You'll need to have the `@modelcontextprotocol/sdk` and `@smithery/sdk` packages installed in your client project.\n\nSave the following code as `nmap_mcp_client_example.js`:\n\n```javascript\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { createSmitheryUrl } from \"@smithery/sdk/shared/config.js\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\n\n// Ensure you have your Smithery API key for the server in an environment variable\nconst SMITHERY_API_KEY = process.env.SMITHERY_NMAP_API_KEY || \"your-smithery-api-key-here\"; // Replace with your actual key or ensure env var is set\nconst NMAP_SERVER_URL = \"https://server.smithery.ai/@sideffect263/nmap-mcp-server\"; // Replace with your server URL if different\n\nlet clientInstance;\nlet nmapScanTool;\nlet getInfoTool;\n\nasync function initializeNmapClient() {\n if (clientInstance) {\n console.log(\"Nmap MCP Client already initialized.\");\n return clientInstance;\n }\n\n console.log(\"Initializing Nmap MCP Client...\");\n\n try {\n const config = {}; // Add any specific config for Smithery if needed\n const serverUrl = createSmitheryUrl(\n NMAP_SERVER_URL,\n { config, apiKey: SMITHERY_API_KEY }\n );\n\n const transport = new StreamableHTTPClientTransport(serverUrl);\n\n clientInstance = new Client({\n name: \"ExampleNmapClient\",\n version: \"1.0.0\",\n });\n\n console.log(\"Connecting to Nmap MCP server...\");\n await clientInstance.connect(transport);\n console.log(\"Successfully connected to Nmap MCP server.\");\n\n const toolsResponse = await clientInstance.listTools();\n \n if (toolsResponse && toolsResponse.tools && Array.isArray(toolsResponse.tools)) {\n console.log(`Available tools: ${toolsResponse.tools.map((t) => t.name).join(\", \")}`);\n nmapScanTool = toolsResponse.tools.find(tool => tool.name === 'nmapScan');\n getInfoTool = toolsResponse.tools.find(tool => tool.name === 'getInfo');\n } else {\n throw new Error(\"Could not list tools from the server.\");\n }\n\n if (!nmapScanTool) {\n throw new Error(\"Nmap tool ('nmapScan') not found on the MCP server.\");\n }\n console.log(`Found Nmap tool: ${nmapScanTool.name}`);\n\n if (getInfoTool) {\n console.log(`Found GetInfo tool: ${getInfoTool.name}`);\n } else {\n console.warn(\"GetInfo tool ('getInfo') not found. This might be optional.\");\n }\n \n return clientInstance;\n } catch (error) {\n console.error(\"Failed to initialize Nmap MCP client:\", error);\n clientInstance = null; // Reset on failure\n nmapScanTool = null;\n getInfoTool = null;\n throw error;\n }\n}\n\n/**\n * Invokes the 'nmapScan' tool on the MCP server.\n * @param {Object} params - Parameters for the Nmap tool.\n * @param {string} params.target - The target IP, hostname, or CIDR.\n * @param {string} params.flags - Nmap flags as a single string (e.g., \"-A -T4\").\n * @returns {Promise

MCP directory API