Simple

Provides a basic MCP server with calculator and note management tools for client integration.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "xarsenicx-simple-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/server.js"
      ]
    }
  }
}

You run a lightweight MCP server that exposes two practical toolsets you can call from an MCP client: a Calculator for basic arithmetic and a Note Manager to create, read, list, and delete notes. This server demonstrates core MCP concepts in a simple, beginner-friendly way and lets you integrate actions into your conversational workflow.

How to use

Connect to the MCP server from your MCP client to access the Calculator and Note Management tools. You can perform arithmetic operations by asking for a calculation, or manage notes by adding, retrieving, listing, or deleting notes. The server is designed so your client can request specific actions using clear tool names and parameters.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

npm install

Start the MCP server using the standard npm start workflow.

npm start

Additional setup and configuration

To connect an MCP client, you configure the client to launch the local MCP server process. The example below shows how to wire the server so your client can start it as a subprocess.

{
  "mcpServers": {
    "simple_mcp": {
      "command": "node",
      "args": ["/path/to/your/server.js"]
    }
  }
}

Usage examples with the client

While connected, you can ask for actions such as:

"Calculate 15 + 27"
"Add a note titled 'Meeting' with content 'Team standup at 2pm'"
"Show me my note called 'Meeting'"
"List all my notes"

Understanding MCP

This server illustrates key MCP concepts: tools, schema for tool parameters, a transport layer (stdio in this setup), and structured error handling for invalid inputs.

File Structure

├── package.json        # Dependencies and scripts
├── server.js          # Main MCP server implementation
└── README.md          # This file

Available tools

calculator

Performs arithmetic operations by specifying the operation (add, subtract, multiply, divide) and the two numeric operands.

add_note

Creates a new note with a title and content.

get_note

Retrieves the content of a note by its title.

list_notes

Lists all note titles currently stored on the server.

delete_note

Deletes a note identified by its title.