What is io.github.Hamzaaamin/get-joke?

Minimal MCP server that returns a random programming joke.

How do I install io.github.Hamzaaamin/get-joke?

Clone io.github.Hamzaaamin/get-joke from https://github.com/Hamzaaamin/Get-Joke and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is io.github.Hamzaaamin/get-joke open source?

Yes, io.github.Hamzaaamin/get-joke is open source under the MIT license. Source code is available at https://github.com/Hamzaaamin/Get-Joke.

What category does io.github.Hamzaaamin/get-joke belong to?

io.github.Hamzaaamin/get-joke is listed under Developer Tools MCP servers on MCPFind.

io.github.Hamzaaamin/get-joke — MCP Server for Developer Tools

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.

Publish to npm (once):

npm adduser
npm publish --access public

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

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-hamzaaamin-get-joke": {
      "command": "npx",
      "args": [
        "-y",
        "@hamzaamin221/get-joke-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.Hamzaaamin/get-joke works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.Hamzaaamin/get-joke