aamangeldi-dad-jokes-mcp

Dad Jokes MCP Server

icanhazdadjoke.com のダジャレを提供する、軽量な Model Context Protocol（MCP）サーバーです。

機能

• 🎭 ランダムなダジャレを取得
• 🔍 キーワードでダジャレを検索
• 🆔 ID を指定してダジャレを取得
• ⚡ 高速で軽量
• 🚀 Smithery へのデプロイに対応

ツール

get_random_joke_tool

ランダムなダジャレを取得します。

例：

{}

search_jokes_tool

指定した語句を含むダジャレを検索します。

パラメーター：

• term（string、必須）：ダジャレを検索する語句
• limit（integer、任意）：返すダジャレの数（デフォルト：5、最大：30）

例：

{
  "term": "pizza",
  "limit": 3
}

get_joke_by_id_tool

ID を指定してダジャレを取得します。

パラメーター：

• joke_id（string、必須）：取得するダジャレの ID

例：

{
  "joke_id": "R7UfaahVfFd"
}

ローカル開発

前提条件

• Python 3.11+
• pip

セットアップ

1. リポジトリをクローンします：

git clone https://github.com/aamangeldi/dad-jokes-mcp.git
cd dad-jokes-mcp

2. 仮想環境を作成し、依存関係をインストールします：

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install fastmcp smithery httpx

3. サーバーをローカルで実行します：

fastmcp run server.py

Smithery へのデプロイ

1. コードを GitHub にプッシュします
2. リポジトリを Smithery に接続します
3. Smithery が設定を自動的に検出し、サーバーをデプロイします

サーバーでは以下を使用します：

• smithery.yaml の runtime: python
• サーバーの実装に FastMCP
• 設定に @smithery.server() デコレーター

設定

サーバーの使用に認証や設定は必要ありません。無料の icanhazdadjoke.com API を使用し、以下のデフォルト値を適用します：

• API：https://icanhazdadjoke.com
• API キーは不要
• レート制限は icanhazdadjoke.com のポリシーに従います

クレジット

ダジャレの提供元：icanhazdadjoke.com

ライセンス

MIT License — 詳細は LICENSE ファイルをご覧ください