Servidor MCP para SmileAPI

SmileAPI 用 MCP サーバー

これは SmileAPI と連携するための MCP（Model Context Protocol）サーバーです。言語モデル向けに提供されるツールを通じて、テキスト、画像、動画、音声、ドキュメントを送信できます。

要件

• Node.js 14+ がインストールされていること
• SmileAPI のアカウントとアクセス認証情報

インストール

Smithery 経由でインストールする

Smithery 経由で、Claude Desktop 用の smileapi-mcp を自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install @edupoli/smileapi-mcp --client claude

手動でインストールする

1. このリポジトリをクローンします
2. 依存関係をインストールします。

npm install

3. 環境変数を設定します。

cp .env.example .env

4. .env ファイルを編集して、SmileAPI の認証情報を設定します。

SMILE_API_USERNAME=seuusername
SMILE_API_PHONE_NUMBER_ID=seuphoneID
SMILE_API_TOKEN=seutoken

使用方法

MCP サーバーとして使用する

MCP サーバーを起動するには、次のコマンドを実行します。

npm start

ツールを直接呼び出す

コマンドラインからツールを直接実行することもできます。

# Enviar texto
node index.js envia_texto '{"to":"5543996611437","text":"Olá, esta é uma mensagem de teste!"}'

# Enviar imagem
node index.js envia_imagem '{"to":"5543996611437","link":"https://exemplo.com/imagem.jpg","caption":"Imagem de teste"}'

# Enviar vídeo
node index.js envia_video '{"to":"5543996611437","link":"https://exemplo.com/video.mp4","caption":"Vídeo de teste"}'

# Enviar áudio
node index.js envia_audio '{"to":"5543996611437","link":"https://exemplo.com/audio.mp3"}'

# Enviar documento
node index.js envia_documento '{"to":"5543996611437","link":"https://exemplo.com/documento.pdf","caption":"Documento de teste","fileName":"documento.pdf"}'

利用可能なツール

envia_texto

テキストメッセージを送信します。

パラメーター：

• to：宛先の電話番号（例：5543996611437）
• delayMessage：メッセージ送信までの遅延時間（秒）（任意、デフォルト：0）
• delayTyping：入力をシミュレートする遅延時間（秒）（任意、デフォルト：0）
• text：メッセージのテキスト

envia_imagem

画像を送信します。

パラメーター：

• to：宛先の電話番号
• delayMessage：送信までの遅延時間（秒）（任意、デフォルト：0）
• link：画像の URL
• caption：画像のキャプション（任意）
• viewOnce：画像を一度だけ表示するかどうかを指定します（任意、デフォルト：false）

envia_video

動画を送信します。

パラメーター：

• to：宛先の電話番号
• delayMessage：送信までの遅延時間（秒）（任意、デフォルト：0）
• link：動画の URL
• caption：動画のキャプション（任意）
• viewOnce：動画を一度だけ表示するかどうかを指定します（任意、デフォルト：false）

envia_audio

音声を送信します。

パラメーター：

• to：宛先の電話番号
• delayMessage：送信までの遅延時間（秒）（任意、デフォルト：0）
• link：音声の URL

envia_documento

ドキュメントを送信します。

パラメーター：

• to：宛先の電話番号
• delayMessage：送信までの遅延時間（秒）（任意、デフォルト：0）
• link：ドキュメントの URL
• caption：ドキュメントのキャプション（任意）
• fileName：ドキュメントのファイル名（任意）

言語モデルとの連携

このサーバーは、MCP プロトコルに対応した言語モデルでの利用を想定して設計されており、SmileAPI を通じたメッセージ送信を可能にします。