MCP项目在Cursor编辑器中的配置问题解析

问题背景

在将AWS Labs的MCP（Model Code Provider）项目集成到Cursor编辑器时，开发者可能会遇到"无可用工具"的提示。这种情况通常发生在按照官方文档配置.cursor/mcp.json文件后，尽管配置看似正确，但Cursor编辑器无法识别已配置的MCP服务器。

配置分析

典型的.cursor/mcp.json配置包含多个MCP服务器定义，例如：

{
  "mcpServers": {
    "awslabs.core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    },
    "awslabs.cdk-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.cdk-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

常见问题原因

1. 路径问题：Cursor编辑器可能无法解析相对路径或环境变量中的可执行文件路径
2. 权限问题：uvx工具可能没有足够的执行权限
3. 环境变量配置：AWS凭证或区域设置不正确
4. 版本兼容性：Cursor或uvx版本不匹配

解决方案

使用绝对路径

最有效的解决方案是使用uvx的绝对路径替代简单的命令名。例如：

{
  "mcpServers": {
    "awslabs.core-mcp-server": {
      "command": "/usr/local/bin/uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

其他排查步骤

1. 验证uvx安装：在终端中直接运行uvx --version确认安装正确
2. 检查Cursor权限：确保Cursor有权限访问系统路径
3. 简化配置：先配置一个MCP服务器进行测试
4. 查看日志：设置FASTMCP_LOG_LEVEL为DEBUG获取更多信息

最佳实践建议

1. 在配置文件中使用绝对路径
2. 先测试单个MCP服务器配置
3. 确保AWS凭证在系统环境中可用
4. 保持Cursor和uvx工具为最新版本
5. 对于团队项目，考虑将路径配置为环境变量

通过以上方法，大多数Cursor无法识别MCP工具的问题都可以得到解决。如果问题仍然存在，建议检查Cursor的开发者控制台获取更详细的错误信息。