mcpField
G
Get Joke

Get Joke

远程服务
github.com/Hamzaaamin游戏娱乐028 周前更新

关于 Get Joke

Get Joke 是一个基于 Node.js 的轻量 MCP 服务,通过单个工具返回随机编程笑话。它适用于需要在 MCP 客户端中获取笑话的场景。

主要功能

  1. 01提供 get_joke 工具
  2. 02返回随机编程笑话
  3. 03以 JSON 形式返回结果

适用场景

  1. 01在对话中获取编程笑话
  2. 02验证 MCP 客户端的工具调用

MCP 相关

作为 MCP 服务,向客户端暴露 get_joke 工具,用于获取随机编程笑话。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"Get-Joke": {
"command": "npx",
"args": [
"-y",
"@hamzaamin221/get-joke-mcp"
]
}
}
}
启动命令npx -y @hamzaamin221/get-joke-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@hamzaamin221/get-joke-mcp0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Get Joke MCP 服务

简易的 Model Context Protocol(MCP)服务(Node.js),仅提供一个工具:get_joke。

设置

npm install

运行

node index.js

或者:

npm start

测试(不使用 Inspector)

此仓库包含一个基于 SDK 的小型客户端,可通过 stdio 启动服务、列出工具并调用 get_joke:

npm run test:mcp

工具响应格式

get_joke 工具返回的 JSON 如下:

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

发布到 MCP Registry(官方)

官方 MCP Registry 仅存储元数据,因此你必须先将软件包发布到 npm。

  1. 发布到 npm(一次即可):
npm adduser
npm publish --access public
  1. 将元数据发布到 MCP Registry:
brew install mcp-publisher
mcp-publisher login github
mcp-publisher publish

注意:

  • package.json 包含 mcpName,且 server.json 使用相同的 name(验证所必需)。
  • 如果更改版本,请同时更新 package.json 和 server.json 中的版本(并重新发布到 npm)。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。