Jsonplaceholder MCP Server

🚀 JSONPlaceholder MCP Server

A Model Context Protocol (MCP) server implementation that provides tools for interacting with the JSONPlaceholder API and basic calculator functionality.

🚀 Quick Start

Prerequisites

• Node.js (v18.0.0 or higher to support native fetch functionality)
• npm or yarn

📦 Installation

1. Clone the repository.
2. Install the dependencies:

npm install

Starting the Server

You can run the server using npm scripts:

# Run the default JSONPlaceholder server (default)
npm start

# Run the calculator server
npm run start:calculator

# Explicitly run the JSONPlaceholder server
npm run start:jsonplaceholder

✨ Features

• Calculator Server: Supports basic arithmetic operations (addition, subtraction).
• JSONPlaceholder Server: Provides access to JSONPlaceholder API data:
  • Users
  • Posts
  • Comments
  • Albums
  • Todos

💻 Usage Examples

VS Code Integration

This project includes a VS Code integration configuration. The MCP server can be accessed through VS Code settings:

Method 1: In the .vscode/mcp.json file

{
  "servers": {
    "my-calc": {
      "command": "node",
      "args": ["/path/to/servers/calculator.js"]
    },
    "my-mcp-server": {
      "command": "node",
      "args": ["/path/to/servers/jsonplaceholder.js"]
    }
  }
}

Method 2: In your settings.json

"mcp": {
  "servers": {
    "my-calc": {
      "command": "node",
      "args": [
        "/path/to/servers/calculator.js"
      ]
    },
    "my-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/servers/jsonplaceholder.js"
      ]
    }
  }
}