Smallcloud

Provides a minimal MCP server demo with a hello tool for Claude Desktop and MCP hosts.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-smallcloudco_smallcloud-mcp-server": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "~/Git/smallcloud-mcp-server/index.js"
      ]
    }
  }
}

You can run a small, self-contained MCP server locally to expose a simple toolset for MCP clients. This demo server focuses on a single tool that returns a greeting and is designed to be easy to run and experiment with in Claude Desktop or other MCP hosts.

How to use

To use this MCP server with an MCP client, start the local server and then connect your client to the provided stdio endpoint. The server exposes tools you can invoke from your MCP client, such as a simple get_hello tool that returns a greeting.

How to install

Prerequisites are Node.js (version 18 or later recommended) and npm.

# Prerequisites
node -v
npm -v

# Installation steps
# 1) Clone the repository
git clone https://github.com/your-org/smallcloud-mcp-server.git
cd smallcloud-mcp-server

# 2) Install dependencies
npm install

# 3) Run the server
node index.js

Claude Desktop configuration on MacOS

To make the MCP Server appear in Claude Desktop on MacOS, configure the MCP server entry by pointing to the local Node.js runtime and the server script.

{
  "mcpServers": {
    "smallcloud-mcp-server": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "~/Git/smallcloud-mcp-server/index.js"
      ]
    }
  }
}

Note: Adjust the path to index.js to match your local repository location.

## Project structure and tooling

The server is implemented in a single entry point and includes a minimal test suite. The main server file is `index.js` and tests live under `test/server.test.js`. The server offers a simple tool named `get_hello` that returns a greeting.

## Development notes

If you are contributing or running tests, you can use the existing npm test script to verify server startup and tool listing functionality.

npm test


## Available tools

### get\_hello

A demonstration endpoint/tool that returns a simple `Hello, World!` message for MCP clients.