Joke Generator MCP

Pythonで構築されたシンプルなModel Context Protocol（MCP）サーバーで、開発者向けおよびプログラミング関連のジョークを提供します。

目的

このプロジェクトは、MCPサーバーの構造、テスト、デプロイ方法を理解するためのMCP学習ワークフローの一環として構築されています。

Related MCP server: Jokes MCP Server

機能

• ツール：

  • get_random_joke：ランダムな開発者ジョークを返します。

  • get_joke_by_topic：特定のプログラミングトピック（例：Python、JavaScript、CSS）に基づいたジョークを返します。

セットアップとインストール

1. リポジトリをクローンまたはダウンロード

2. 依存関係のインストール： Python 3.10以上がインストールされていることを確認してください。パッケージをローカルにインストールします：

   pip install -e .

使用法（ローカルテスト）

stdioを使用してMCPサーバーを直接実行できます：

python -m joke_mcp

MCP Inspectorでのテスト

サーバーを対話的にテストするには、公式のMCP Inspectorを使用します：

npx @modelcontextprotocol/inspector python -m joke_mcp

これにより、このサーバーが提供するツールを呼び出せるローカルWebインターフェースが起動します。

Smitheryへのデプロイ

このプロジェクトには、Smitheryマーケットプレイスへの簡単なデプロイのためのsmithery.yaml設定ファイルが含まれています。

1. コードが公開のGitHubリポジトリでホストされていることを確認してください。

2. Smitheryにアクセスし、「Add Server」をクリックします。

3. リポジトリのURLを入力します。Smitheryがsmithery.yamlを読み取り、ビルドを自動的に設定します。

学習成果

• mcp Python SDKを使用してツールを作成する方法を実演しました。

• 標準的なPythonパッケージ構造をセットアップしました。

• MCPマーケットプレイスを通じた公開共有の準備をしました。