Fonoster MCP サーバー

Fonoster API用のMCPサーバー。MCPクライアントがFonosterのテレフォニーサービスと連携できるようにします。このモジュールは、 Fonosterオープンソースプロジェクトの一部です。プロジェクトの詳細については、 https://github.com/fonoster/fonosterをご覧ください。

ツール

list_numbers
- Fonoster から数値のリストを表形式で返します (マークダウンを使用)
- オプション入力:
  - page_size (数値): 返される数値の最大数
  - page_token (文字列): 次のページのページネーショントークン
- 戻り値: 参照、名前、telUrl を含む番号のリスト
list_applications
- Fonoster のアプリケーションを表形式（マークダウンを使用）でリストします
- オプション入力:
  - page_size (数値): 返されるアプリケーションの最大数
  - page_token (文字列): 次のページのページネーショントークン
- 戻り値: 参照、名前、エンドポイント、作成日、更新日、およびタイプを含むアプリケーションのリスト
create_call
- Fonosterからの通話を作成する
- 必要な入力:
  - from (文字列): 発信元の番号
  - to (文字列): 電話をかける番号
  - app_ref (文字列): 呼び出しに使用するアプリケーションへの参照
  - metadata （オブジェクト）：アプリケーションに送信されるメタデータ
- 戻り値: 参照IDを含むコール作成確認
create_call_batch
- Fonosterからの呼び出しのバッチを作成します
- 必要な入力:
  - from (文字列): 発信元の番号
  - to_array (配列): 呼び出す番号
  - app_ref (文字列): 呼び出しに使用するアプリケーションへの参照
  - metadata （オブジェクト）：アプリケーションに送信されるメタデータ
- 戻り値: 参照ID付きのバッチ作成確認

プロンプト

create_call_prompt
- 通話を段階的に作成するためのプロンプト
- MCP クライアントを次のプロセスに導きます:
  - 電話番号がまだ提供されていない場合は、ユーザーに電話をかける番号を尋ねる
  - list_numbersツールを使用して利用可能な番号のリストを提供する
  - アプリケーション名を尋ねてその参照を見つける
  - ユーザーのリクエストに応じて、 create_callまたはcreate_call_batchツールを使用して通話を作成する

設定

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

コマンドラインツールにログインしている場合は、 fonoster mcp:configure --client claude実行するだけでサーバーを構成できます。

npx

{
  "mcpServers": {
    "fonoster": {
      "command": "npx",
      "args": [
        "-y",
        "@fonoster/mcp"
      ],
      "env": {
        "WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}

ドッカー

{
  "mcpServers": {
    "fonoster": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WORKSPACE_ACCESS_KEY_ID",
        "-e",
        "APIKEY_ACCESS_KEY_ID",
        "-e",
        "APIKEY_ACCESS_KEY_SECRET",
        "fonoster/mcp"
      ],
      "env": {
        "WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}

MCP Inspectorによるテスト

WORKSPACE_ACCESS_KEY_ID="your-workspace-access-key-id" \
APIKEY_ACCESS_KEY_ID="your-apikey-access-key-id" \
APIKEY_ACCESS_KEY_SECRET="your-apikey-access-key_secret" \
npx @modelcontextprotocol/inspector \
node /path/to/fonoster/mods/mcp/dist/index.js

トラブルシューティング

認証エラーが発生した場合は、次の点を確認してください。

Fonosterの資格情報は正しいです
環境変数が適切に設定されている
Fonoster APIにアクセスするために必要な権限があります

建てる

Dockerビルド:

docker build -t fonoster/mcp -f Dockerfile .

Fonoster MCP Server

Integrations