# get-joke [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Hamzaaamin/Get-Joke  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/get-joke

## Description
Minimal MCP server that returns a random programming joke.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "get-joke": {
    "command": "npx",
    "args": ["-y","get-joke"]
  }
}
```

## Documentation & README

# 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 tools, and calls `get_joke`:

```bash
npm run test:mcp
```

## Tool response shape

The `get_joke` tool returns JSON like:

```json
{
  "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):

```bash
npm adduser
npm publish --access public
```

2) Publish metadata to the MCP Registry:

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