Twilio呼叫服务

通过NerveSparks CI API创建Twilio呼叫的MCP服务器。

  • by Dev3-web
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Dev3-web/mcp

使用说明

NerveSparks MCP服务器

MCP服务器,用于通过NerveSparks CI API创建Twilio调用。

在游标中使用

要在游标中使用此MCP服务器,您需要在游标的MCP设置中对其进行配置。

先决条件

  1. 构建Docker镜像 (如果你还没有):

    docker build -t nervesparks-mcp:latest .
    

    或者,如果使用Docker Hub发布的镜像:

    docker pull YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest
    docker tag YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest nervesparks-mcp:latest
    
  2. 确保Docker桌面正在运行 在你的机器上。

配置步骤

  1. 打开Cursor的MCP配置文件:

    • 配置文件位于: ~/.cursor/mcp.json (或 %APPDATA%\Cursor\mcp.json 在Windows上)
    • 如果文件不存在,请创建它。
  2. 添加MCP服务器配置:

    将以下配置添加到您的 mcp.json 文件:

    {
      "mcpServers": {
        "nervesparks-python-mcp": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "nervesparks-mcp:latest"
          ]
        }
      }
    }
    

    注: 如果您已经配置了其他MCP服务器,请添加 nervesparks-python-mcp 进入现有 mcpServers 对象。

  3. 重新启动游标 加载新的MCP服务器配置。

  4. 验证连接:

    • MCP服务器现在应该可以在Cursor中使用
    • 您可以通过要求Cursor使用 ping 工具或 createCall 工具
    • 检查Cursor的MCP状态/连接指示灯,确认其已连接

配置文件示例

如果这是您的第一台MCP服务器 ~/.cursor/mcp.json 应该看起来像:

{
  "mcpServers": {
    "nervesparks-python-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "nervesparks-mcp:latest"
      ]
    }
  }
}

故障排除

  • MCP服务器未出现在游标中:

    • 验证Docker镜像是否存在: docker images | grep nervesparks-mcp
    • 检查Docker桌面是否正在运行
    • 确保JSON语法在 mcp.json 有效
    • 更改配置后重新启动Cursor
  • 连接错误:

    • 如果容器无法启动,请检查Docker日志
    • 验证映像名称是否完全匹配: nervesparks-mcp:latest

发布到Docker Hub

要使您的镜像可供他人使用,请将其发布到Docker Hub:

先决条件

  • Docker Hub帐户(在https://hub.docker.com)
  • Docker桌面已安装并正在运行

发布步骤

  1. 登录Docker Hub:

    docker login
    
  2. 用你的Docker Hub用户名标记你的镜像:

    docker build -t YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest .
    docker tag nervesparks-mcp:latest YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest
    
  3. 推送到Docker Hub:

    docker push YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest
    

    或者使用提供的脚本:

    chmod +x publish.sh
    ./publish.sh YOUR_DOCKERHUB_USERNAME
    
  4. 公开(可选):

    • 首选https://hub.docker.com
    • 查找您的存储库: YOUR_DOCKERHUB_USERNAME/nervesparks-mcp
    • 前往设置→ 能见度→ 公开

使用已发布的图像

一旦发布,任何人都可以提取和使用您的图像:

docker pull YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest
docker run -it --name nervesparks-mcp-server YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest

或更新 docker-compose.yml 要使用已发布的图像,请执行以下操作:

services:
  mcp-server:
    image: YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest
    # ... rest of config

Docker部署

先决条件

  • Docker桌面已安装并正在运行
  • Docker Compose(包含在Docker桌面中)

快速开始

  1. 使用Docker Compose构建和运行:

    docker-compose up --build
    
  2. 在分离模式下运行(后台):

    docker-compose up -d --build
    
  3. 查看日志:

    docker-compose logs -f
    
  4. 停止容器:

    docker-compose down
    

直接使用Docker

  1. 塑造形象:

    docker build -t nervesparks-mcp:latest .
    
  2. 运行容器:

    docker run -it --name nervesparks-mcp-server nervesparks-mcp:latest
    
  3. 在分离模式下运行:

    docker run -d --name nervesparks-mcp-server nervesparks-mcp:latest
    

连接到MCP服务器

由于此MCP服务器使用stdio,您需要配置MCP客户端以连接到Docker容器的stdio。确切的配置取决于您的MCP客户端设置。

故障排除

  • 检查容器是否正在运行:

    docker ps
    
  • 查看容器日志:

    docker logs nervesparks-mcp-server
    
  • 重新启动容器:

    docker restart nervesparks-mcp-server
    
  • 移除容器:

    docker rm -f nervesparks-mcp-server