Minimal MCP Server

This project demonstrates how to build a Model Context Protocol (MCP) server using the TypeScript SDK. It provides a minimal implementation in index.ts and includes two examples showcasing its usage.

Features

• Minimal MCP Server: A lightweight server implementation using the MCP TypeScript SDK.
• Tool Support: Includes tools for calculating the area of a rectangle and retrieving calculation history.
• Examples: Demonstrates how to interact with the server and use the tools.

Prerequisites

• Node.js (v16 or higher)
• TypeScript

Installation

1. Clone the repository:

   git clone <repository-url>
   

2. Navigate to the project directory:

   cd minimal-mcp-server
   

3. Install dependencies:

   npm install
   

Usage

Build the Project

Compile the TypeScript code:

npm run build

Run the Server

Start the MCP server:

node index.js

Examples

1. Calculate Area

Send a request to calculate the area of a rectangle:

{
  "name": "calculate_area",
  "arguments": {
    "width": 5,
    "height": 10
  }
}

Response:

{
  "content": [{ "type": "text", "text": "Result: 50. Added to history." }]
}

2. Get Calculation History

Retrieve the history of previous calculations:

{
  "name": "get_calculation_history",
  "arguments": {}
}

Response:

{
  "content": [{ "type": "text", "text": "History: [\"Untitled: 5x10 = 50\"]" }]
}

Project Structure

• index.ts: Contains the minimal MCP server implementation.
• package.json: Project metadata and dependencies.
• tsconfig.json: TypeScript configuration.

Dependencies

• @modelcontextprotocol/sdk: MCP TypeScript SDK for building servers.
• @types/node: Type definitions for Node.js.
• typescript: TypeScript compiler.

License

This project is licensed under the ISC License.

How to Use

To use this minimal MCP server, you can configure it as follows:

{
  "mcpServers": {
    "my-minimal-server": {
      "command": "node",
      "args": ["/absolute/path/to/minimal-mcp-server/index.js"]
    }
  }
}

Sample Usage