About io.github.Hamzaaamin/get-joke
io.github.Hamzaaamin/get-joke is an MCP server in the Browser category: minimal MCP server that returns a random programming joke.
Install
claude mcp add io-github-hamzaaamin-get-joke -- npx -y @hamzaamin221/get-joke-mcpnpx -y @hamzaamin221/get-joke-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.Hamzaaamin/get-joke
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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.
- 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.jsonincludesmcpNameandserver.jsonuses the samename(required for verification).- If you change the version, bump it in both
package.jsonandserver.json(and republish to npm).
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.