MCP Chucknorrisjokes

查克·诺里斯MCP服务器

一个模型上下文协议（MCP）服务器，提供访问查克·诺里斯笑话的功能 查克·诺里斯API。

特点/功能

• 随机笑话通过MCP工具获取随机的查克·诺里斯笑话
• 错误处理针对API故障和网络问题的健壮错误处理
• 记录日志全面的日志记录用于调试和监控

先决条件

• Python 3.8 或更高版本

安装

1. 克隆或下载此仓库

1. 设置虚拟环境 （推荐）：

   python3 -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

1. 安装依赖项：

   pip install -r requirements.txt

用法

运行服务器

source .venv/bin/activate
python3 server.py

服务器将启动并监听标准输入/输出（stdin/stdout）上的MCP协议消息。

API 参考

get_random_joke

从API中获取一个随机的查克·诺里斯笑话。

参数无

退货一个包含笑话文本的字符串。

配置

• API基础URL: https://api.chucknorris.io/jokes
• 超时API请求需10秒
• 日志级别INFO（使用 --debug 用于DEBUG级别的标志，日志记录到 logs/chuck_norris_server.log)

与MCP客户端的集成

Claude Desktop（克劳德桌面版）

在您的（内容/列表/计划等）中添加以下内容： claude_desktop_config.json （通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json （在 macOS 上）：

{
  "mcpServers": {
    "chuck-norris": {
      "command": "python3",
      "args": ["/path/to/your/mcp-chucknorris/server.py"],
      "env": {
        "PATH": "/path/to/your/mcp-chucknorris/.venv/bin:$PATH"
      }
    }
  }
}

替换 /path/to/your/mcp-chucknorris 使用您项目目录的实际路径。

Claude 插件（VSCode 扩展）

在你的VSCode中 settings.json，添加：

{
  "claude-code.mcpServers": {
    "chuck-norris": {
      "command": "python3",
      "args": ["server.py"],
      "cwd": "/path/to/your/mcp-chucknorris"
    }
  }
}

Kilo Code（VSCode 扩展）

在你的VSCode中 settings.json，添加：

{
  "kilo-code.mcpServers": {
    "chuck-norris": {
      "command": "python3",
      "args": ["server.py"],
      "cwd": "/path/to/your/mcp-chucknorris"
    }
  }
}

VSCode中的GitHub Copilot

如果使用支持MCP的GitHub Copilot扩展，请在VSCode中添加它 settings.json：

{
  "github.copilot.mcpServers": {
    "chuck-norris": {
      "command": "python3",
      "args": ["server.py"],
      "cwd": "/path/to/your/mcp-chucknorris"
    }
  }
}

许可证

这个项目是开源的。请随意使用并根据需要进行修改。