Skip to main content
Glama
syashwanth3110

first-node-mcp-server

README.md
# 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:

```bash
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:

```bash
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:

```json
{
  "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:

```json
{
  "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.