mcpField
G
Get Joke

Get Joke

Remote
github.com/HamzaaaminGames & Entertainment0Updated 28w ago
Repository

About Get Joke

Get Joke is a minimal Node.js MCP server that returns a random programming joke through a single tool. It fits use in MCP clients that need a joke tool.

Key features

  1. 01Provides the get_joke tool
  2. 02Returns a random programming joke
  3. 03Returns the result as JSON

Use cases

  1. 01Get a programming joke in a conversation
  2. 02Check tool calls from an MCP client

MCP support

As an MCP server, it exposes the get_joke tool to clients for retrieving a random programming joke.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "Get-Joke": {
      "command": "npx",
      "args": [
        "-y",
        "@hamzaamin221/get-joke-mcp"
      ]
    }
  }
}
Run commandnpx -y @hamzaamin221/get-joke-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@hamzaamin221/get-joke-mcp0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. 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).

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.