Fonoster MCP Server

Fonoster API 的 MCP 服务器，使 MCP 客户端能够与 Fonoster 的电话服务进行交互。此模块是 Fonoster 开源项目的一部分。有关项目的更多信息，请访问 https://github.com/fonoster/fonoster。

工具

1. list_numbers

   • 返回 Fonoster 中号码列表的表格形式（使用 Markdown）
   • 可选输入：
     • page_size (数字)：返回的最大号码数量
     • page_token (字符串)：分页标记，用于下一页
   • 返回值：包含号码引用、名称和 telUrls 的号码列表

2. list_applications

   • 列出 Fonoster 中应用程序的表格形式（使用 Markdown）
   • 可选输入：
     • page_size (数字)：返回的最大应用程序数量
     • page_token (字符串)：分页标记，用于下一页
   • 返回值：包含应用程序引用、名称、端点、创建日期、更新日期和类型的列表

3. create_call

   • 创建 Fonoster 的呼叫
   • 必要输入：
     • from (字符串)：呼叫来源号码
     • to (字符串)：呼叫目标号码
     • app_ref (字符串)：用于呼叫的应用程序引用
     • metadata (对象)：发送给应用程序的元数据
   • 返回值：呼叫创建确认，包含参考ID

4. create_call_batch

   • 批量创建 Fonoster 的呼叫
   • 必要输入：
     • from (字符串)：呼叫来源号码
     • to_array (数组)：呼叫目标号码列表
     • app_ref (字符串)：用于呼叫的应用程序引用
     • metadata (对象)：发送给应用程序的元数据
   • 返回值：批量创建确认，包含参考ID

提示

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

docker

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

故障排除

如果您遇到身份验证错误，请检查：

1. 您的 Fonoster 凭证是否正确
2. 环境变量是否设置正确
3. 您是否有访问 Fonoster API 的必要权限

构建

Docker 构建：

docker build -t fonoster/mcp -f Dockerfile .