syashwanth3110/first-node-mcp-server

First Node MCP Server

A simple Model Context Protocol (MCP) server implementation in Node.js that provides an addition tool.

About

This project implements a basic MCP server that exposes an "add" tool which adds two numbers together. It demonstrates how to create a simple Model Context Protocol server using the MCP SDK.

Prerequisites

• Node.js (v18 or later recommended)
• npm

Installation

Clone the repository and install dependencies:

git clone https://github.com/syashwanth3110/first-node-mcp-server.git
npm install -y

Running Locally

You can run the MCP server locally by piping JSON-RPC requests to it:

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "add", "arguments": {"a": 5, "b": 3}}}' | node mcp.js

This will call the add tool with arguments a=5 and b=3, which should return 8.

Configuring as an MCP Server

To use this server with an MCP-compatible client (like an AI assistant), add the following configuration to your MCP config file:

{
  "mcpServers": {
    "demo-server-yash": {
      "command": "/path/to/node",
      "args": ["/path/to/first-node-mcp-server/mcp.js"],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

Replace /path/to/node with your Node.js executable path, and /path/to/first-node-mcp-server/mcp.js with the absolute path to your mcp.js file.

Example configuration:

{
  "mcpServers": {
    "demo-server-yash": {
      "command": "/opt/homebrew/opt/node@18/bin/node",
      "args": ["/Users/syashwanth/Source/first-node-mcp-server/mcp.js"],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

Available Tools

Add Tool

Adds two numbers together.

• Tool Name: add
• Input Parameters:
  • a: First number (required)
  • b: Second number (required)
• Output: Sum of the two numbers

License

MIT

Contributing

Feel free to submit issues and pull requests.