Example MCP Server

This repository contains a minimal Model Context Protocol (MCP) server written in Node.js. The server exposes two simple tools that can be called from AI assistants (such as Claude Desktop or Cursor) via the MCP standard.

Tools provided

These tools are defined in the index.js file using the McpServer class from the official SDK. You can extend this server by registering your own tools with custom parameters and logic.

Installation

1. Install Node.js (version 20 or later is recommended).

2. Clone this repository and install dependencies:

   npm install
   

   The @modelcontextprotocol/sdk package is published on npm. This example uses version 1.17.0 as referenced in package.json. MCP requires Node.js 18.x or higher to run properly364465667226308L72-L78.

Running the server

Run the server with Node:

npm start

By default the server uses the StdioServerTransport to communicate. This means it will read JSONRPC 2.0 messages from stdin and write responses to stdout. Tools like Claude Desktop or Cursor will manage this communication for you.

Connecting with Claude Desktop

To connect this server to Claude Desktop, add an entry in your mcp.json configuration file (usually located in your ~/.claude/ or ~/.cursor/ directory depending on the client). An example configuration looks like this:

{
  "mcpServers": {
    "example-server": {
      "command": "/absolute/path/to/node",
      "args": [
        "/absolute/path/to/index.js"
      ]
    }
  }
}

Replace the command path with the absolute path to your Node binary (e.g. the output of which node) and update the args path to point to this project's index.js file.

After saving the config, restart your Claude Desktop app, grant permission to the tools when prompted, and you can invoke them by writing natural language instructions like:

Add 3 and 5. Claude will call the add tool and return the sum.

Whats the current time? Claude will call the getTime tool and return the timestamp.

References

• The concept of MCP servers is described in Anthropics announcement714031847317279L20-L36 and documented in several tutorials67709559959600L144-L178.
• For an example of defining tools with the official SDK, see the minimal server from the mcp-server-node project966057210205090L0-L18.

License

This example is provided for educational purposes. Modify and adapt it to suit your own MCP workflows.