Fonoster MCP 服务器

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

工具

1. list_numbers

   • 以表格格式（使用 markdown）返回来自 Fonoster 的号码列表
   • 可选输入：
     • page_size (数字)：要返回的最大号码数量
     • page_token (字符串)：下一页的分页令牌
   • 返回：带有其 refs、名称和 telUrls 的号码列表

2. list_applications

   • 以表格格式（使用 markdown）列出来自 Fonoster 的应用程序
   • 可选输入：
     • page_size (数字)：要返回的最大应用程序数量
     • page_token (字符串)：下一页的分页令牌
   • 返回：带有其 refs、名称、端点、创建日期、更新日期和类型的程序列表

3. create_call

   • 从 Fonoster 创建通话
   • 必需输入：
     • from (字符串)：呼叫方的号码
     • to (字符串)：被叫方的号码
     • app_ref (字符串)：用于呼叫的应用程序引用
   • 返回：带有参考 ID 的呼叫创建确认

4. create_call_batch

   • 从 Fonoster 创建一批通话
   • 必需输入：
     • from (字符串)：呼叫方的号码
     • to_array (数组)：被叫方的号码列表
     • app_ref (字符串)：用于呼叫的应用程序引用
   • 返回：带有参考 ID 的批量呼叫创建确认

提示

1. create_call_prompt
   • 逐步创建通话的提示
   • 引导 Claude 完成以下过程：
     • 如果尚未提供，则询问用户要拨打的号码或号码
     • 使用 list_numbers 工具提供可用号码列表
     • 询问应用程序名称并找到其引用
     • 根据用户的请求使用 create_call 或 create_call_batch 工具创建通话

设置

与 Claude Desktop 一起使用

将以下内容添加到您的 claude_desktop_config.json 中：

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 检查器测试

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 .