Get Joke

by Hamzaaamin

105 downloads
Not rated
GitHub

Description

# Get Joke MCP Server Minimal Model Context Protocol (MCP) server (Node.js) that exposes one tool: `get_joke`. ## Setup ```bash npm install ``` ## Run ```bash node index.js ``` Or: ```bash npm start ``` ## Test (without Inspector) This repo includes a tiny SDK-based client that…

About

# Get Joke MCP Server Minimal Model Context Protocol (MCP) server (Node.js) that exposes one tool: `get_joke`. ## Setup ```bash npm install ``` ## Run ```bash node index.js ``` Or: ```bash npm start ``` ## Test (without Inspector) This repo includes a tiny SDK-based client that spawns the server over stdio, lists…

Details

Author
Hamzaaamin
Downloads
105
Categories
Other

- Exposes one tool: get_joke
- Returns a joke as JSON
- Written in Node.js
- Supports the Model Context Protocol
- Includes a built-in test client
- Can be published to the MCP Registry

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 Get Joke
    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 with npm install, then run with node index.js or npm start. A test client is included that spawns the server over stdio, lists tools, and calls get_joke via npm run test:mcp.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "get joke": {
            "shabaaspay": {
                "url": "https://mcp.so/submit",
                "transport": "http",
                "headers": {
                    "Authorization": "sbp_live_44625cbe2cc7dbe1688d4241a14996200c423b026481e3c695b7ded0ddfa5895"
                }
            }
        }
    }
}

McpServers

{
    "shabaaspay": {
        "url": "https://mcp.so/submit",
        "transport": "http",
        "headers": {
            "Authorization": "sbp_live_44625cbe2cc7dbe1688d4241a14996200c423b026481e3c695b7ded0ddfa5895"
        }
    }
}

Get Joke MCP Server

Minimal Model Context Protocol (MCP) server (Node.js) that exposes one tool: get_joke.

Setup

npm install

Run

node index.js

Or:

npm start

Test (without Inspector)

This repo includes a tiny SDK-based client that spawns the server over stdio, lists tools, and calls get_joke:

npm run test:mcp

Tool response shape

The get_joke tool returns JSON like:

{
  "joke": "Why do programmers prefer dark mode? Because light attracts bugs."
}

Publish to the MCP Registry (official)

The official MCP Registry stores metadata only, so you must publish the package to npm first.

1) Publish to npm (once):

npm adduser
npm publish --access public

2) Publish metadata to the MCP Registry:

brew install mcp-publisher
mcp-publisher login github
mcp-publisher publish

Notes:
- package.json includes mcpName and server.json uses the same name (required for verification).
- If you change the version, bump it in both package.json and server.json (and republish to npm).

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.