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

1. Clone the repository
2. 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:

1. Copy this template
2. Modify the TOOLS array
3. Implement custom tool handlers in server.fallbackRequestHandler
4. 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