MCP-JS -Template

This MCP server template provides a minimal but functional MCP server built with JavaScript and the @modelcontextprotocol/sdk. It exposes two basic tools: about and hello. The about tool returns information about the MCP server, such as its name and version, while the hello tool greets a user and can take an optional name parameter. The server is designed to be extended: you can modify the TOOLS array to add more commands and implement custom tool handlers in server.fallbackRequestHandler. Claude Desktop can interact with the server through its configured tools, enabling you to leverage MCP primitives within your workflows. The server follows the MCP protocol version 2024-11-05 and uses the sdk to handle protocol details, error handling, and logging.

Prerequisites:

• Node.js (v16 or later)
• Claude Desktop
• npm (comes with Node.js)

Installation steps:

1. Clone the repository to your local machine.
2. Install dependencies:

npm install @modelcontextprotocol/sdk

3. (Optional) verify your Node.js version:

node -v

4. Replace the placeholder path in Claude Desktop configuration with the actual path to your server file (simplified-template-mcp-server.js) and adjust any environment options as needed.

Tips:

• The template is a starting point; consider adding proper error handling and input validation for production use.
• If you publish or share tools, document their input parameters and return formats clearly.
• Ensure the Node options (NODE_OPTIONS) in Claude Desktop configuration are appropriate for your environment to avoid deprecation warnings and to maintain compatibility.
• When extending, update the server name, version, and any tool handlers to reflect your custom implementation.
• Check MCP protocol compatibility with Claude Desktop updates and adjust your implementation if protocol revisions occur.