Party Time MCP

🚀 Party Time MCP サーバー

シンプルなMCPサーバーで、現在時刻を問われたときに「It's Party Time」と返答します。

🚀 クイックスタート

このサーバーは、MCPプロトコルを簡単に実装したもので、標準入力から読み取り、標準出力に書き込みます。get-timeというツールを登録しており、これが呼び出されると常に「It's Party Time」と応答します。

✨ 主な機能

• MCPプロトコルを実装し、JSON - RPCメッセージを処理して適切に応答します。
• get-timeツールを登録し、その呼び出しに「It's Party Time」で応答します。

📦 インストール

macOSインストール手順

1. 実行ファイルのビルド

まず、実行ファイルをビルドします。

mix deps.get
mix escript.build

これにより、プロジェクトディレクトリにparty_time_mcpという名前の実行ファイルが作成されます。実行権限を付与しましょう。

chmod +x ./party_time_mcp

2. Claudeデスクトップの設定

1. Claudeの設定ファイルを開きます。

nano ~/.config/claude/settings.json

2. ファイルの末尾に以下の内容を追加して、実験的機能を有効にします。

{
  "experimental_features": {
    "custom_mcp_server": true
  }
}

3. 編集を保存してエディタを終了します。

3. Claudeデスクトップの起動

Claudeデスクトップを起動すると、指定したMCPサーバーに自動的に接続されます。デフォルトでは、localhost:5001でサーバーを探します。

💻 使用例

基本的な使用法

サーバーが正常に動作しているかを確認するには、以下のコマンドを実行します。

curl -X POST http://localhost:5001 -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "tools/list"}'

正常に動作していれば、以下のような応答が返されます。

{
  "jsonrpc": "2.0",
  "result": ["get-time"],
  "id": "some-id"
}

🔧 技術詳細

最近の修正点

通知処理

サーバーは、Claudeデスクトップから送信されるnotifications/initializedメッセージを正しく処理するように更新されました。このメッセージは、クライアントがserver/initialized通知を受け取ったことを確認するために送信されます。

• notifications/initializedメッセージのサポートを追加しました。
• サーバーはこの通知をエラーなく正しく処理するようになりました。

JSON解析エラー

サーバーは、Claudeデスクトップで発生するJSON解析エラーを修正するように更新されました。問題は、サーバーがログメッセージを標準出力に出力し、JSON応答と混ざってしまい、JSON解析器が混乱することに起因していました。

• すべてのログ記録を無効にして、JSON出力への干渉を避けました。
• 標準出力にはクリーンなJSON応答のみを送信するようになりました。
• 重複する起動メッセージを削除しました。
• 各JSON応答の後に改行を追加して、解析を改善しました。

Mix.env()エラーの修正

サーバーは、実行時に発生するUndefinedFunctionError: function Mix.env/0 is undefinedエラーを修正するように更新されました。この問題は、escriptではMixモジュールが使用できないことが原因でした。

• 実行時のMix.env()呼び出しをコンパイル時定数に置き換えました。
• サーバーは、Mixに依存せずにテストモードかどうかを正しく判断できるようになりました。

トラブルシューティング

UndefinedFunctionError: function Mix.env/0 is undefined

このエラーが表示された場合は、実行ファイルのビルドが正しく行われていないことを示しています。このエラーは、escriptではMixモジュールが使用できないことが原因です。解決策は以下の通りです。

mix escript.build

権限問題

実行ファイルを実行しようとしたときに権限拒否エラーが発生した場合は、実行権限を付与します。

chmod +x ./party_time_mcp

設定ファイルの問題

サーバーが設定ファイルを見つけられない、または読み取れない場合は、ファイルが存在し、正しい権限を持っていることを確認してください。

JSONエラー

JSON解析エラーが表示された場合は、サーバーに入力するメッセージが有効なJSON - RPC 2.0形式であることを確認してください。サーバーは以下のようなメッセージ形式を期待しています。

{
  "jsonrpc": "2.0",
  "id": "some-id",
  "method": "method-name",
  "params": {}
}

応答を必要としない通知（返信のないメッセージ）の場合は、idフィールドを省略します。

{
  "jsonrpc": "2.0",
  "method": "notification-name"
}