Sum MCP Server

A simple Model Context Protocol (MCP) server that demonstrates making fetch requests to external APIs.

Features

This MCP server provides two tools:

1. calculate-sum: Calculates the sum of two numbers and fetches data from an external API
2. fetch-random-data: Fetches random user data from an external API service

Installation

npm install
npm run build

Usage

As a local MCP server

You can run the server locally:

npm start

As an npm package (for deployment)

To use this MCP server in your MCP client configuration, you can publish it to npm or use it locally:

{
  "mcpServers": {
    "sum-mcp": {
      "command": "npx",
      "args": ["-y", "@eloquentops/sum-mcp"]
    }
  }
}

Local development/testing

For local testing, you can reference the built file directly:

{
  "mcpServers": {
    "sum-mcp": {
      "command": "node",
      "args": ["/path/to/sum/build/index.js"]
    }
  }
}

Tools Available

calculate-sum

• Description: Calculates the sum of two numbers by making a request to a math API service
• Parameters:
  • a (number): First number to add
  • b (number): Second number to add
• Example: calculate-sum with a: 5, b: 3 will return 8 plus API data

fetch-random-data

• Description: Fetches random data from an external API service
• Parameters: None
• Example: Returns random user information from JSONPlaceholder API

Development

The server is built with TypeScript and uses:

• @modelcontextprotocol/sdk for MCP server functionality
• zod for input validation
• Native fetch API for HTTP requests

API Services Used

This server makes requests to:

• JSONPlaceholder API (https://jsonplaceholder.typicode.com/) for demonstration purposes
• You can modify the URLs in the source code to use different APIs