Skip to main content
Glama
srafi26

MCP Server

by srafi26
README.md
# MCP Server

A Model Context Protocol (MCP) server implementation that provides basic tools and utilities.

## Features

This MCP server provides the following tools:

- **echo**: Echo back the input text
- **uppercase**: Convert text to uppercase
- **calculate**: Perform basic mathematical calculations (add, subtract, multiply, divide)

## Installation

1. Install dependencies:
   ```bash
   npm install
   ```

2. Build the server:
   ```bash
   npm run build
   ```

## Usage

### Development
Run the server in development mode:
```bash
npm run dev
```

### Production
Build and run the server:
```bash
npm run build
npm start
```

## Configuration

To use this MCP server with Claude Desktop or other MCP clients, add the following to your MCP configuration:

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": ["/path/to/your/mcp-server/dist/index.js"]
    }
  }
}
```

## Examples

### Echo Tool
```json
{
  "name": "echo",
  "arguments": {
    "message": "Hello, World!"
  }
}
```

### Uppercase Tool
```json
{
  "name": "uppercase",
  "arguments": {
    "text": "hello world"
  }
}
```

### Calculate Tool
```json
{
  "name": "calculate",
  "arguments": {
    "operation": "add",
    "a": 5,
    "b": 3
  }
}
```

## License

MIT

TDQS

B3.2/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: calculate performs mathematical operations, echo returns input text unchanged, and uppercase transforms text to uppercase. There is no overlap in functionality, making tool selection straightforward for an agent.

Naming Consistency5/5

All tool names follow a consistent pattern of using simple, descriptive verbs (calculate, echo, uppercase) without any mixing of conventions like camelCase or snake_case. This uniformity enhances readability and predictability.

Tool Count3/5

With only 3 tools, the server feels thin for a general-purpose MCP server, as it lacks coverage for common operations like data manipulation beyond text or more advanced utilities. However, the count is not extreme and could be appropriate for a minimal utility set.

Completeness2/5

The tool set is severely incomplete for a general-purpose server, missing essential operations such as text transformation beyond uppercase (e.g., lowercase, substring), mathematical functions beyond basic calculations, or other utility tasks. This will likely cause agent failures in broader scenarios.

Maintenance

ActivityInactive
ResponsivenessNo issues