Comedy MCP Server

Comedy MCP Server

AI アシスタント向けに、コメディ関連のツールやサービスを提供する Model Context Protocol（MCP）サーバーの実装です。このサーバーは Cursor IDE と連携し、MCP ツールを通じてさまざまなコメディ関連の機能を提供します。

概要

Comedy MCP Server は ASP.NET Core を使用して構築されており、Model Context Protocol（MCP）を実装することで、AI アシスタントにプログラミングジョークや面白いコードコメントを生成するツールを提供します。AI モデルとコメディ関連の機能をつなぐ役割を果たします。

機能

• プログラミングジョーク：プログラミング関連のジョークをランダムに生成します
• コードコメント：コードのコンテキストやトピックに基づいて、ユーモアのあるコメントを作成します
• エコーサービス：ログ機能を紹介するデモサービスです
• Swagger 連携：API ドキュメントとテスト用インターフェースを提供します
• ヘルスチェックエンドポイント：基本的なサーバー状態の監視機能です

アーキテクチャ

サーバーは次のコンポーネントで構成されています。

• MCP サーバー連携：MCP の実装に ModelContextProtocol.Server を使用します
• コメディサービス：ジョークやコメントの生成に IComedyService を実装します
• HTTP 通信：Cursor IDE との通信に stdio を使用します
• ログ記録：設定可能なレベルで包括的なログを記録します
• CORS サポート：MCP inspector ツール向けに設定されています

ツール

サーバーは次の MCP ツールを提供します。

1. GetProgrammingJoke

   • 説明：プログラミング関連のジョークをランダムに取得します
   • パラメーター：なし
   • 戻り値：ジョークを含む文字列

2. GetCodeComment

   • 説明：特定のコードコンテキストに関連する面白いコメントを生成します
   • パラメーター：
     • codeContext：コードスニペットまたはコンテキスト
     • topic：コメントのトピック
   • 戻り値：コードに関連するユーモアのあるコメント

3. EchoWithLog

   • 説明：ログを記録しながらメッセージをエコーするデモ用ツールです
   • パラメーター：
     • message：エコーするメッセージ
   • 戻り値：エコーされたメッセージ

セットアップと設定

前提条件

• .NET 8.0 SDK 以降
• Node.js 14+（MCP inspector ツール用）
• コードエディター（最適な連携には Cursor IDE を推奨）
• Git（バージョン管理用）

インストール手順

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

git clone [your-repository-url]
cd ComedyMcpServer

2. 環境をセットアップします。

   • 環境ファイルのサンプルをコピーします。

     copy .env.example .env    # On Windows
     # OR
     cp .env.example .env     # On Unix-based systems
     

   • 必要に応じて、.env ファイルを設定に合わせて更新します

3. 依存関係をインストールします。

dotnet restore

4. プロジェクトをビルドします。

dotnet build

サーバーの実行

サーバーを実行する方法はいくつかあります。

1. 開発モード：

dotnet run --environment Development

2. MCP Inspector を使用（MCP ツールのデバッグに推奨）：

npx @modelcontextprotocol/inspector dotnet run

3. 本番モード：

dotnet run --environment Production

インストールの確認

1. サーバーが実行中であることを確認します。

   • ブラウザーで http://localhost:5000 または設定したポートにアクセスします
   • 「Comedy MCP Server is running!」というメッセージが表示されます

2. Swagger ドキュメントにアクセスします。

   • http://localhost:5000/swagger に移動します
   • API ドキュメントが表示されます

3. MCP ツールをテストします。

   • 付属のテストスクリプトを使用します。

     node test-mcp.js
     

   • または、inspector を使用して実行している場合は MCP inspector インターフェースを使用します

トラブルシューティング

よくある問題と解決方法：

1. ポートがすでに使用されています。

   • appsettings.json でポートを変更します
   • または、現在のポートを使用しているプロセスを停止します

2. 依存関係が不足しています。

   • dotnet restore を再度実行します
   • .NET SDK のバージョンがプロジェクトの要件に合っているか確認します

3. 環境変数が読み込まれません。

   • .env ファイルが存在し、形式が正しいことを確認します
   • 環境ファイルを変更した後、アプリケーションを再起動します

詳細な問題については、コンソール出力にあるアプリケーションログを確認してください。

開発

このプロジェクトでは、MCP 固有のコンポーネントを追加した標準的な ASP.NET Core のプラクティスに従っています。

• サービスは DI コンテナーに登録されます
• ツールはアセンブリから自動的に検出されます
• ログは開発とデバッグ用に設定されています
• API ドキュメントには Swagger を利用できます

デプロイ

このプロジェクトには以下が含まれています。

• Procfile：プラットフォームへのデプロイ用
• nixpacks.toml：ビルド設定
• 標準的な ASP.NET Core のデプロイオプション

テスト

MCP の機能を検証するためのテストスクリプト（test-mcp.js）が含まれています。

ヘルスチェック

ルートエンドポイント（/）にアクセスして、サーバーの状態を確認します。

GET / -> "Comedy MCP Server is running!"

API ドキュメント

実行中に、以下から Swagger UI にアクセスします。

/swagger

コントリビューション

以下の方法でぜひ貢献してください。

1. コメディ関連の新しいツールを実装する
2. 既存のジョーク生成機能を強化する
3. エラー処理とログを改善する
4. 新しいコメディサービスを追加する

ライセンス

[ライセンス情報はこちら]