🎭 Joke MCP Server

シンプルでありながら強力なModel Context Protocol (MCP)サーバーで、AIとの対話にユーモアをもたらします。このMCPは、ランダムなジョーク生成をツールとして公開し、Claudeやその他のMCP互換クライアントとシームレスに統合できます。

✨ 特徴

• get_random_joke - セットアップとオチ付きのランダムなジョークを取得します

• count_jokes - データベース内の利用可能なジョークの総数を取得します

• シンプル＆軽量 - 最小限の依存関係、高速な実行

• 簡単な統合 - Claude Desktopやその他のMCPクライアントで動作します

• 充実したドキュメント - 明確なスキーマと使用例

Related MCP server: Jokes MCP Server

🚀 クイックスタート

前提条件

• Python 3.11以上

• pipパッケージマネージャー

インストール

# Clone the repository
git clone https://github.com/tehrimaly/mcp-joke.git
cd mcp-joke

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\Activate.ps1
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

サーバーの実行

python joke-mcp.py

次のように表示されます：

🚀 Joke MCP Server starting...

📖 使用方法

Claude Desktopでの使用

これをClaude Desktopの設定ファイルに追加してください：

macOS/Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "joke-mcp": {
      "command": "python",
      "args": ["/path/to/joke-mcp.py"]
    }
  }
}

その後、Claude Desktopを再起動すると、Claudeにジョークを言ってもらうことができます！

APIリファレンス

get_random_joke

セットアップとオチ付きのランダムなジョークを返します。

入力: なし

出力:

Setup: Why don't scientists trust atoms?

Punchline: Because they make up everything!

count_jokes

データベース内の利用可能なジョークの総数を返します。

入力: なし

出力:

Total jokes: 5

🏗️ プロジェクト構造

mcp-joke/
├── joke-mcp.py          # Main MCP server implementation
├── requirements.txt      # Python dependencies
├── README.md            # This file
├── .gitignore           # Git configuration
└── LICENSE              # MIT License

🔧 技術詳細

使用技術

• Python 3.11+ - プログラミング言語

• MCP SDK v1.0.0 - Model Context Protocolライブラリ

• Asyncio - 非同期プログラミング

動作の仕組み

Joke MCP Serverは：

1. stdioで待ち受けるMCPサーバーを起動します

2. 利用可能なツールをスキーマとともに登録します

3. MCPクライアントからのリクエストを処理します

4. ジョークデータを含むフォーマット済みのレスポンスを返します

# Tool registration example
@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="get_random_joke",
            description="Get a random joke",
            inputSchema={...}
        )
    ]

# Tool execution
@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "get_random_joke":
        # Return random joke

📦 依存関係

• mcp==1.0.0 - Model Context Protocol SDK

完全な依存関係リストはrequirements.txtを参照してください。

🎯 現在の機能

✅ 5つの組み込みジョーク ✅ Async/awaitサポート ✅ クリーンなエラーハンドリング ✅ スキーマベースのシンプルなツール定義 ✅ Stdoutロギング

🔮 今後の拡張予定

• ジョークのカテゴリを追加（親父ギャグ、ダジャレ、ダークユーモア）

• 難易度レベルを実装

• ジョークの評価/フィードバックを追加

• 外部のジョークAPIに接続

• ユーザーのお気に入りを保存

• 多言語サポート

• ジョーク管理用のWeb UI

🤝 コントリビューション

以下のことを自由に行ってください：

• データベースにジョークを追加する

• ドキュメントを改善する

• バグを報告する

• 新機能を提案する

📝 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🔗 リンク

• GitHub: https://github.com/tehrimaly/mcp-guide

• MCP Specification: https://spec.modelcontextprotocol.io/

• Anthropic MCP Docs: https://modelcontextprotocol.io/

💡 使用例

1. AIアシスタント統合 - Claudeとの対話にユーモアを追加

2. Slackボット - チームコミュニケーションにジョークを統合

3. 学習ツール - MCP実装の基本を理解

4. テンプレート - 独自のMCPサーバーの出発点として使用

🐛 トラブルシューティング

問題: モジュールが見つからないエラー

pip install -r requirements.txt

問題: ポートが既に使用中 このサーバーはポートではなくstdioを使用します。この問題は発生しないはずです。

問題: サーバーが起動しない

• Pythonのバージョンを確認（3.11以上）

• すべての依存関係がインストールされているか確認

• 構文エラーを確認

📧 サポート

問題、質問、提案がある場合は、GitHubのissueを開いてください。