MCP JS Server Template

🚀 MCP JS Server Template

This is a simplified template for creating a Model Context Protocol (MCP) server integrated with Claude Desktop. It offers a basic structure for developing custom MCP servers, reducing boilerplate code.

🚀 Quick Start

This template simplifies the process of creating an MCP server integrated with Claude Desktop. It provides a basic structure and necessary tools to get you started quickly.

✨ Features

• Implement standard MCP server initialization.
• Provide two basic tools: about and hello.
• Comply with MCP protocol version 2024-11-05.
• Use the @modelcontextprotocol/sdk for server implementation.
• Include error handling and logging.

📦 Installation

Prerequisites

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

Steps

1. Clone the repository.
2. Install dependencies:

npm install @modelcontextprotocol/sdk

📚 Documentation

Claude Desktop Configuration

Add the following configuration to the 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 the server name and version.

Limitations

• Simple error handling.
• No advanced security features.
• Serves as a starting point for custom implementations.

🤝 Contribution

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

📄 License

This project is licensed under the MIT License.