MCP Server Nodejs Docs

🚀 Node.js API Documentation MCP Server Documentation

This project implements a Model Context Protocol (MCP) server that provides access to the official Node.js API documentation. It scrapes the documentation from nodejs.org and exposes it through MCP tools.

✨ Features

• Scrape the latest Node.js API documentation.
• Provide an MCP tool to query documentation for specific modules, classes, or methods.
• Offer a search tool (node-search) to find modules or list all available modules and their methods.
• Provide a list tool (node-list) to obtain an overview of all available modules.
• Use pino to log activities and errors to /tmp/mcp-server-nodejs-docs.log.

📦 Installation

1. Clone the repository (if necessary):

   git clone <repository_url>
   cd <repository_directory>
   

2. Install dependencies: This project requires Node.js and npm.

   npm install
   

💻 Usage Examples

Basic Usage

To start the MCP server, run the following command in the terminal:

npm run start

The server will initialize, scrape the documentation, create the necessary tools, and then listen for connections via standard input/output (stdio).

Advanced Usage

To enable debug logging, start the server with the --debug flag:

node index.js --debug

📚 Documentation

Debugging

The server logs detailed information about its operations, including scraping, tool execution, and errors, to the following file:

/tmp/mcp-server-nodejs-docs.log

You can monitor this file to debug issues:

tail -f /tmp/mcp-server-nodejs-docs.log

Testing with the MCP Inspector

Use the built-in debug script:

npm run debug

Or directly via npx:

npx -y @modelcontextprotocol/inspector node index.js

Connecting to an MCP Client

This server communicates via standard input/output (stdio). To connect it to an MCP client (such as Cursor or Qodo AI), you need to configure the client to start the server using its command.

Example Configuration (Conceptual): Most clients have a settings section where you can add a custom MCP server. You usually need to provide the following information:

1. Name: For example, "Node.js API Documentation"
2. Command: The command to execute the server. Make sure to provide the absolute path to node and the path to the index.js file, or ensure that node is in the PATH environment variable accessible to the client.

   # Example - replace with your actual paths
   /path/to/your/node /path/to/your/project/index.js
   

   • Find the Node path: Run which node in the terminal.
   • Find the project path: Navigate to the project directory and run pwd.

Refer to the specific MCP client documentation for the exact steps to add an stdio-based server.

Example with Cursor:

1. Go to Settings -> Cursor Settings -> MCP Servers
2. Click Add Server
3. Enter a name (e.g., "NodeJS API Documentation")
4. Enter the full command in the Command field, e.g., /Users/youruser/.nvm/versions/node/v20.11.1/bin/node /Users/youruser/projects/mcp-server-nodejs-docs/index.js (replace with your actual paths).
5. Save the settings
6. Follow the client's instructions to complete the rest of the configuration

📄 License

No license information provided in the original document.

👨‍💻 Author Information

[Author's Name]
[Contact Information]