Servidor MCP de Fonoster

Servidor MCP para la API de Fonoster, que permite a los clientes MCP interactuar con los servicios de telefonía de Fonoster. Este módulo forma parte del proyecto de código abierto Fonoster . Para más información sobre el proyecto, visite https://github.com/fonoster/fonoster .

Herramientas

list_numbers
- Devuelve una lista de números de Fonoster en formato de tabla (usando markdown)
- Entradas opcionales:
  - page_size (número): Número máximo de números a devolver
  - page_token (cadena): Token de paginación para la página siguiente
- Devuelve: Lista de números con sus referencias, nombres y telUrls
list_applications
- Enumera las aplicaciones de Fonoster en formato de tabla (usando markdown)
- Entradas opcionales:
  - page_size (número): Número máximo de aplicaciones a devolver
  - page_token (cadena): Token de paginación para la página siguiente
- Devuelve: Lista de aplicaciones con sus referencias, nombres, puntos finales, fechas de creación, fechas de actualización y tipos
create_call
- Crea una llamada desde Fonoster
- Entradas requeridas:
  - from (cadena): el número desde el que llamar
  - to (cadena): el número al que llamar
  - app_ref (cadena): La referencia a la aplicación que se utilizará para la llamada
  - metadata (objeto): Metadatos que se enviarán a la aplicación
- Devuelve: Confirmación de creación de llamada con ID de referencia
create_call_batch
- Crea un lote de llamadas desde Fonoster
- Entradas requeridas:
  - from (cadena): el número desde el que llamar
  - to_array (matriz): Los números a los que llamar
  - app_ref (cadena): La referencia a la aplicación que se utilizará para la llamada
  - metadata (objeto): Metadatos que se enviarán a la aplicación
- Devoluciones: Confirmación de creación de lote con ID de referencia

Indicaciones

create_call_prompt
- Un mensaje para crear una llamada paso a paso
- Guía a un cliente de MCP a través del proceso de:
  - Solicitar al usuario el número o los números a los que llamar si aún no los ha proporcionado
  - Ofrecer una lista de números disponibles utilizando la herramienta list_numbers
  - Solicitar el nombre de la aplicación y encontrar su referencia
  - Creación de una llamada utilizando la herramienta create_call o create_call_batch según la solicitud del usuario

Configuración

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Si ha iniciado sesión en la herramienta de línea de comandos, simplemente ejecute fonoster mcp:configure --client claude para configurar el servidor.

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"
      }
    }
  }
}

estibador

{
  "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"
      }
    }
  }
}

Pruebas con el inspector MCP

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

Solución de problemas

Si encuentra errores de autenticación, verifique que:

Sus credenciales de Fonoster son correctas
Las variables de entorno están configuradas correctamente
Tienes los permisos necesarios para acceder a la API de Fonoster

Construir

Compilación de Docker:

docker build -t fonoster/mcp -f Dockerfile .

Fonoster MCP Server

Integrations