MCP Server

🚀 Puch AI用MCPスターター

このスターターテンプレートは、Puch AIと連携する独自のモデルコンテキストプロトコル（MCP）サーバーを作成するためのものです。求人情報検索や画像処理など、すぐに使えるツールが用意されています。

🚀 クイックスタート

MCPとは何ですか？

MCP（モデルコンテキストプロトコル）は、PuchのようなAIアシスタントが外部のツールやデータソースに安全に接続できるようにするものです。セキュリティを損なうことなく、AIに追加の機能を付与するようなものと考えてください。

このスターターに含まれるものは何ですか？

🎯 求人情報検索ツール

• 求人内容の分析 - 任意の求人内容を貼り付けると、賢い洞察が得られます。
• URLからの求人情報取得 - 求人のリンクを入力すると、詳細な情報が得られます。
• 求人検索 - 自然言語を使って関連する求人機会を検索できます。

🖼️ 画像処理ツール

• 画像を白黒に変換 - 任意の画像をアップロードすると、モノクロ版が得られます。

🔐 組み込み認証

• ベアラートークン認証（Puch AIが必要とするもの）
• 電話番号を返す検証ツール

クイックセットアップガイド

ステップ1: 依存関係のインストール

まず、Python 3.11以上がインストールされていることを確認してください。その後、以下のコマンドを実行します。

# 仮想環境の作成
uv venv

# 必要なパッケージをすべてインストール
uv sync

# 環境をアクティブ化
source .venv/bin/activate

ステップ2: 環境変数の設定

プロジェクトのルートに.envファイルを作成します。

# サンプルファイルをコピー
cp .env.example .env

次に、.envファイルを編集し、以下の詳細を追加します。

AUTH_TOKEN=your_secret_token_here
MY_NUMBER=919876543210

⚠️ 重要提示

• AUTH_TOKEN：これは認証用の秘密のトークンです。安全に保管してください！
• MY_NUMBER：あなたのWhatsApp番号を{国番号}{番号}の形式で入力してください（例：+91-9876543210の場合は919876543210）

ステップ3: サーバーの起動

cd mcp-bearer-token
python mcp_starter.py

次のメッセージが表示されます。🚀 Starting MCP server on http://0.0.0.0:8086

ステップ4: サーバーを公開する（Puchが必要とする）

PuchがHTTPS経由でサーバーにアクセスする必要があるため、ローカルサーバーを公開する必要があります。

オプションA: ngrokを使用する（推奨）

1. ngrokをインストールする：https://ngrok.com/download からダウンロードします。
2. 認証トークンを取得する：
   • https://dashboard.ngrok.com/get-started/your-authtoken にアクセスします。
   • 認証トークンをコピーします。
   • 次のコマンドを実行します。ngrok config add-authtoken YOUR_AUTHTOKEN
3. トンネルを起動する：

ngrok http 8086

オプションB: クラウドにデプロイする

以下のようなサービスにデプロイすることもできます。

• Railway
• Render
• Heroku
• DigitalOcean App Platform

Puch AIとの接続方法

1. Puch AIを開く：ブラウザで開きます。
2. 新しい会話を開始する
3. 接続コマンドを使用する：

/mcp connect https://your-domain.ngrok.app/mcp your_secret_token_here

デバッグモード

より詳細なエラーメッセージを取得するには、以下のコマンドを実行します。

/mcp diagnostics-level debug

スターターのカスタマイズ

新しいツールの追加

1. 新しいツール関数を作成する：

@mcp.tool(description="Your tool description")
async def your_tool_name(
    parameter: Annotated[str, Field(description="Parameter description")]
) -> str:
    # Your tool logic here
    return "Tool result"

2. 必要に応じてインポートを追加する

📚 ドキュメント

Puch AI MCP公式ドキュメント

• メインドキュメント：https://puch.ai/mcp
• プロトコル互換性：ベアラーとOAuthサポートを含むCore MCP仕様
• コマンドリファレンス：完全なMCPコマンドドキュメント
• サーバー要件：ツール登録、検証、HTTPS要件

技術仕様

• JSON-RPC 2.0仕様：https://www.jsonrpc.org/specification （エラーハンドリング用）
• MCPプロトコル：コアプロトコルメッセージ、ツール定義、認証

サポートされる機能とサポートされない機能

✓ サポートされる機能：

• コアプロトコルメッセージ
• ツール定義と呼び出し
• 認証（ベアラーとOAuth）
• エラーハンドリング

✗ サポートされない機能：

• ビデオ拡張機能
• リソース拡張機能
• プロンプト拡張機能

ヘルプの取得

• Puch AI Discordに参加する：https://discord.gg/VMCnMvYx
• Puch AI MCPドキュメントを確認する：https://puch.ai/mcp
• PuchのWhatsApp番号：+91 99988 81729

Happy coding! 🚀

あなたのMCPに関する投稿では、ハッシュタグ#BuildWithPuchを使用してください！

このスターターを使えば、Puch AI用の独自のMCPサーバーを簡単に作成できます。セットアップ手順に従えば、カスタムツールでPuchを拡張できるようになります！