使用说明
NerveSparks MCP服务器
MCP服务器,用于通过NerveSparks CI API创建Twilio调用。
在游标中使用
要在游标中使用此MCP服务器,您需要在游标的MCP设置中对其进行配置。
先决条件
-
构建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 -
确保Docker桌面正在运行 在你的机器上。
配置步骤
-
打开Cursor的MCP配置文件:
- 配置文件位于:
~/.cursor/mcp.json(或%APPDATA%\Cursor\mcp.json在Windows上) - 如果文件不存在,请创建它。
- 配置文件位于:
-
添加MCP服务器配置:
将以下配置添加到您的
mcp.json文件:{ "mcpServers": { "nervesparks-python-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "nervesparks-mcp:latest" ] } } }注: 如果您已经配置了其他MCP服务器,请添加
nervesparks-python-mcp进入现有mcpServers对象。 -
重新启动游标 加载新的MCP服务器配置。
-
验证连接:
- 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镜像是否存在:
-
连接错误:
- 如果容器无法启动,请检查Docker日志
- 验证映像名称是否完全匹配:
nervesparks-mcp:latest
发布到Docker Hub
要使您的镜像可供他人使用,请将其发布到Docker Hub:
先决条件
- Docker Hub帐户(在https://hub.docker.com)
- Docker桌面已安装并正在运行
发布步骤
-
登录Docker Hub:
docker login -
用你的Docker Hub用户名标记你的镜像:
docker build -t YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest . docker tag nervesparks-mcp:latest YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest -
推送到Docker Hub:
docker push YOUR_DOCKERHUB_USERNAME/nervesparks-mcp:latest或者使用提供的脚本:
chmod +x publish.sh ./publish.sh YOUR_DOCKERHUB_USERNAME -
公开(可选):
- 首选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桌面中)
快速开始
-
使用Docker Compose构建和运行:
docker-compose up --build -
在分离模式下运行(后台):
docker-compose up -d --build -
查看日志:
docker-compose logs -f -
停止容器:
docker-compose down
直接使用Docker
-
塑造形象:
docker build -t nervesparks-mcp:latest . -
运行容器:
docker run -it --name nervesparks-mcp-server nervesparks-mcp:latest -
在分离模式下运行:
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
