SmallCloud MCP Server Demo

by SmallCloudCo

2 stars
168 downloads
Not rated
GitHub

About

SmallCloud MCP Server Demonstration of an Anthropic MCP server using the Model Context Protocol SDK by Anthropic. For use with Claude Desktop and other MCP Hosts.

Details

Author
SmallCloudCo
GitHub stars
2
Downloads
168
Categories
Other

- Demonstration MCP server using Anthropic’s official SDK
- Includes a single tool: get_hello returning "Hello, World!"
- Test suite covering server startup and tool listing
- Designed for Mac OS (Windows may need small adjustments)
- Simple JavaScript implementation (single index.js file)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name SmallCloud MCP Server Demo
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js 18 or later (via Homebrew) and npm. Clone the repository, run npm install to install dependencies, then start the server with node index.js. To integrate with Claude Desktop on MacOS, add the JSON configuration for this server to ~/Library/Application Support/Claude/claude_desktop_config.json, adjusting the path to index.js as needed.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "smallcloud mcp server demo": {
            "smallcloud-mcp-server": {
                "command": "node",
                "args": [
                    "index.js"
                ]
            }
        }
    }
}

McpServers

{
    "smallcloud-mcp-server": {
        "command": "node",
        "args": [
            "index.js"
        ]
    }
}

SmallCloud MCP Server Demo

Overview

SmallCloud MCP Server Demonstration of an Anthropic MCP server using the Model Context Protocol SDK by Anthropic. For use with Claude Desktop and other MCP Hosts.

This is a demo for Mac OS. Windows may require some small adjustments. I would consider creating a package as opposed to just an index.js file (like in this demo) if you expect your MCP solution to be reusable by others.

Visit https://smallcloud.co for more AI/LLM/Coding resources.

Prerequisites

- Node.js (version 18 or later recommended) #installed by homebrow in this example
- npm

Installation

1. Clone the repository:

   git clone https://github.com/your-org/smallcloud-mcp-server.git
cd smallcloud-mcp-server

2. Install dependencies:

   npm install

Usage

Run the server:

node index.js

Claude Desktop Configuration (MacOS)

To make the MCP Server appear in Claude Desktop on MacOS, add the following to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "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.

Available Tools

Currently, the server includes one demonstration tool:
- get_hello: Returns a "Hello, World!" message

Development

Running Tests

To run the test suite:

npm test

The test suite currently checks:
- Server startup
- Tool listing functionality

Project Structure

smallcloud-mcp-server/
│
├── index.js          # Main server implementation used by Claude Desktop. See section "Claude Desktop Configuration (MacOS)"
└── test/
    └── server.test.js # Server test suite

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

[Specify your license here]

Contact

[Your contact information or project maintainer details]

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.