Mock MCP Server

A simple mock Model Context Protocol (MCP) server for demonstration and testing purposes. This server provides basic string manipulation and arithmetic tools.

Features

• No Authentication Required: Works with "NONE" auth type
• Simple Tools: Provides basic text and math operations
• Compatible with AgentBox: Designed to work with the AgentBox platform
• NPX Based: Can be run directly using npx

Installation

Using NPX:

npx @agentboxio/mock-mcp-server

Global installation:

npm install -g @agentboxio/mock-mcp-server
mock-mcp-server

Available Tools

String Operations

• uppercase: Converts a string to uppercase
• lowercase: Converts a string to lowercase
• reverse: Reverses a string

Arithmetic Operations

• add: Adds two numbers together
• subtract: Subtracts the second number from the first
• multiply: Multiplies two numbers together
• divide: Divides the first number by the second (errors on divide by zero)

Utility Operations

• randomNumber: Generates a random number between min and max values (inclusive)
• timestamp: Returns the current timestamp in various formats (iso, unix, readable)
• echo: Returns the input message unchanged

Usage Example

When integrated with AgentBox, you can use these tools like this:

{
  "name": "uppercase",
  "arguments": {
    "text": "hello world"
  }
}

Response:

{
  "content": [
    {
      "type": "text",
      "text": "HELLO WORLD"
    }
  ],
  "isError": false
}

Development

Setup

git clone https://github.com/agentboxio/agentbox.git
cd agentbox/mcp-servers/mock-mcp
npm install

Build

npm run build

Run Locally

npm start

License

MIT