MCP JS Server Template

Overview

This is a simplified template for creating Model Context Protocol (MCP) servers in JavaScript for integration with Claude Desktop. It provides a basic structure for developing custom MCP servers with minimal boilerplate code.

Features

Implements standard MCP server initialization
Provides two basic tools: about and hello
Follows MCP protocol version 2024-11-05
Uses @modelcontextprotocol/sdk for server implementation
Includes error handling and logging

Prerequisites

Node.js (v16 or later)
Claude Desktop
@modelcontextprotocol/sdk npm package

Installation

Clone the repository
Install dependencies:

npm install @modelcontextprotocol/sdk

Claude Desktop Configuration

Add to your Claude Desktop configuration file:

Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration Example:

{
  "mcpServers": {
    "template-server": {
      "command": "node",
      "args": [
        "/full/path/to/simplified-template-mcp-server.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

Available Tools

1. `about`

Returns information about the MCP server.

2. `hello`

Provides a greeting, with an optional name parameter.

Example Usage in Claude:

hello with name="Claude"

Extending the Template

To create your own MCP server:

Copy this template
Modify the TOOLS array
Implement custom tool handlers in server.fallbackRequestHandler
Update server name and version

Limitations

Minimal error handling
No advanced security features
Meant as a starting point for custom implementations

Contributing

Contributions are welcome! Please submit pull requests or open issues.

License

MIT License

MCP JS Server Template